ZeroClaw Nasıl Kurulur: Hafif OpenClaw Alternatifi için Başlangıç Dostu Hızlı Başlangıç

ZeroClaw Neden Yüklemeye Değer

Eğer hiç bir AI aracı yüklediyseniz, ikili dosyasının “PATH” içine indiğini gördüyseniz ve yine de aracının bir modele ulaşabileceğine, çalışma alanını anlayabileceğine veya güvenli bir şekilde yanıt verebileceğine dair hiçbir kanıtınız yoksa, bu rehberin çözdüğü sorunu zaten anlıyorsunuz. Tamamlanmış bir kurulum yalnızca dosyaların kopyalandığını kanıtlar. Agent runtime’ın kullanılabilir olduğunu kanıtlamaz.

ZeroClaw tam da bu noktada ilginç hale gelir. Tek bir Rust ikili dosyası etrafında inşa edilmiş, hafif bir AI agent runtime’ıdır ve ilk günden itibaren yerel bir ağır yığın yerine barındırılan model sağlayıcılarını destekler. Pratikte, bu “terminal’deki bir sohbet botu” yerine “kontrollü bir araç kullanan runtime” olarak daha yakındır. “OpenClaw alternatifi” açısından meraklı okuyucular için pratik çekicilik hype veya kıyaslamalar değildir. Daha hafif kurulum hikayesi, daha düşük bağımlılık ağırlığı ve Ubuntu VPS’de test etmenin tam bir altyapı projesi yerine yönetilebilir hissettirilmesidir.

Bu makale sıkı bir şekilde bir sonuca odaklanır: ZeroClaw’ı kurun, “zeroclaw onboard” çalıştırın, güvenli bir ilk CLI oturumunu doğrulayın ve sonraki denemeye ilişkin gerçekçi bir fikir ile ayrılın. Bu, başlangıç seviyesi dostça bir VPS kılavuzu için doğru ilk kilometre taşıdır, çünkü “çalışan” uzun bir özellik turu değil, kontrol edebileceğiniz temellendirilmiş bir ilk yanıt anlamına gelmelidir.

📝 Not: Bu rehber ilk çalışan CLI kullanımını kanıtlar. Bu bir üretim dağıtım rehberi değildir ve Docker, genel ağ geçitleri veya arka plan hizmetlerini kapsamaya çalışmaz

ZeroClaw Nedir — Sade İngilizce ile

ZeroClaw “bir AI sohbet botu” yerine bir agent runtime olarak daha iyi anlaşılır. Model yalnızca sistemin bir parçasıdır. ZeroClaw, bir sağlayıcı hesabını, bir model seçimini, bir agent profilini ve sınırlı bir çalışma alanını bağlayan katmandır, böylece araç izole bir istemden daha fazlasını yapabilir.

Aşağıdaki dört terim bu öğreticide en önemli olanlarıdır:

Bu çalışma alanı fikri kulağa geldiğinden daha önemlidir. Bu makalede, çalışma alanı aracının çalışmasına izin verilen odadır. Bu nedenle ZeroClaw’ı kurmak, ZeroClaw’ı yapılandırmakla aynı değildir: ikili dosya diskte var olabilir, sağlayıcı, model, alias ve çalışma alanı hala eksik veya yanlış bağlı olabilir.

📝 Not: Başarılı bir kurulum hikayenin yalnızca yarısıdır. Anlamlı kilometre taşı, bir sağlayıcıya ulaşabilen ve görünür bir çalışma alanı içinde çalışabilen ~/.zeroclaw altında çalışan bir yapılandırmadır.

Bu aynı zamanda bazı insanların ZeroClaw’ı OpenClaw alternatifi olarak görmesinin neden en temiz yoludur ve tam bir karşılaştırmayı zorlamaz. Değer “OpenClaw Rust’ta yeniden yazıldı” değildir ve bu rehber bunu bu şekilde ele almaz. Değer daha hafif bir kendi kendine barındırma duruşu, sağlayıcı esnekliği ve bir VPS’de denemeyi kolay hale getiren tek ikili runtime’dır.

İyi ilk kullanım durumları eşit derecede temellendirilmiştir: güvenli bir repo kopyasını özetlemek, bir yapılandırma dosyasını açıklamak, düşük riskli bir çalışma alanı içinde salt okunur bir yardımcı görevini işlemek veya herhangi bir gerçek değişikliğe izin vermeden önce görünürlük isteyen operatörler için sınırlı bir asistan olarak kullanmak.

Kurulmadan önce: Ubuntu temeli, ön koşullar ve güvenlik

Yükleyiciyi çalıştırmadan önce, VPS’nin bu makalenin kullandığı yol için gerçekten iyi bir uyum olup olmadığını doğrulamak için bir dakika harcayın. Minimum gereksinimler basittir: Ubuntu VPS’ye SSH erişimi, curl, API anahtarı olan bir barındırılan sağlayıcı hesabı ve ilk oturum için düşük riskli bir makine veya çalışma alanı.

Önce aşağıdaki kontrolleri çalıştırın. Gösterilen doğrulama çalışmasında, Ubuntu 24.04.4 LTS (Noble Numbat), x86_64 ve /usr/bin/curl döndürdüler. Bu, rehberin temelini her sunucunun aynı çıktı döndüreceğini pretend etmeden doğrulamak için yeterlidir.

cat /etc/os-release

uname -m
command -v curl

Barındırılan sağlayıcı örneği için, OpenRouter en temiz varsayılandır çünkü kılavuzu VPS dostça tutar ve sunucuda yerel model kurulumundan kaçınır. Zaten başka bir desteklenen sağlayıcı kullanıyorsanız, bu iyidir, ancak zeroclaw onboard soru sormaya başlamadan önce API anahtarını hazır bulundurun. Buradaki hedef ilk başarıdır, sağlayıcı alışverişi değildir, bu nedenle bir temiz barındırılan yol her sağlayıcıyı aynı oturumda değerlendirmeye çalışmaktan daha iyidir.

ZeroClaw hem önceden oluşturulmuş hem de kaynak kurulum yollarını destekler. Önceden oluşturulmuş rotayı hazır bir cihaz olarak ve kaynak rotasını kendin yap kiti olarak düşünün. Her ikisi de meşrudur, ancak farklı okuyuculara hizmet ederler. Bu hızlı başlangıç için önemli olan farkı şimdi anlamak ve gerçek kurulum adımında gerçek tavsiyeyi vermektir.

⚠️ Uyarı: İleri gitmeden önce bu ilk çalıştırma kontrol listesini kullanın:

• düşük riskli bir çalışma alanında kalın
• varsayılan denetlenen davranışı tutun
• genel maruziyetten ve üretim verilerinden kaçının
• ilk görevi amaçlı olarak salt okunur yapın

Resmi komut dosyası ile ZeroClaw’ı kurun

Ön kontrol hazırlandığında, resmi yükleyiciyi ana yol olarak kullanın. Bu, Ubuntu VPS hızlı başlangıcı için en kısa desteklenen rotadır:

curl -fsSL https://raw.githubusercontent.com/zeroclaw-labs/zeroclaw/master/install.sh | bash

Bu kurulum yolunda, komut dosyası etkileşimsiz olarak çalışır ve önceden oluşturulmuş sürüm yolunu otomatik olarak alır. Bu rehber için doğrulama çalışmasında, komut dosyası Linux hedefini algıladı, eşleşen GitHub sürüm tarball’ını indirdi, sağlama toplamını doğruladı, web panosu varlıklarını ~/.local/share/zeroclaw/web/dist altına yükledi ve zeroclaw ikili dosyasını ~/.cargo/bin içine yerleştirdi. Ekran görüntüleri root hesabından yakalandığı için, gösterilen somut yollar /root/.local/share/zeroclaw/web/dist, /root/.cargo/bin/zeroclaw ve /root/.bashrc dir; normal bir kullanıcı hesabında, aynı düzeni kendi ev dizininiz altında bekleyin.

Bu hızlı yol bir kısayol veya daha az resmi bir kurulum değildir. Bu rehberin yazıldığı kitle için normal hızlı başlangıç rotasıdır: eşleşen sürümü indirin, doğrulayın ve ikili dosyayı ~/.cargo/bin/zeroclaw içine yerleştirin. Kasıtlı olarak bir kaynak derlemesi istiyorsanız, bu yükleyici akışının ayrı bir derleme seçeneği sunmasını beklemek yerine aşağıdaki repo-klon yolunu kullanın.

💡 İpucu: Linux’ta, kurulum sonrası en yaygın sorun kurulum değil PATH’dir. Yükleyicinin export PATH=”$HOME/.cargo/bin:$PATH” önerisini kabul edin ve bunu source ~/.bashrc ile yeniden yükleyin (veya kabuğu yeniden açın). Yalnızca geçerli oturum için geçici bir düzeltmeye ihtiyacınız varsa, aşağıda gösterilen tek satırlık dışa aktarmayı kullanın.

İkili dosya yerinde olduktan sonra, komut dosyası kurulumu otomatik olarak başlatmak yerine etkileşimsiz bir onay mesajı ile bitirir. Bu rehber için doğrulama çalışmasında, bu kapanış mesajı zeroclaw quickstart önerisinde bulundu, ancak yüklenen “v0.7.5” ikili dosyası zeroclaw –help içinde onboard öğesini gerçek kurulum alt komutu olarak ortaya çıkardı. Ayrıca zeroclaw daemon öğesinin her zaman açık daemon artı web panosu yolu olduğunu ve zeroclaw agent öğesinin tek seferlik CLI sohbet yolu olduğunu işaret eder.

Bu makale için sonraki adımda zeroclaw onboard ile devam edin. Bu, kılavuzu makalenin gerçek vaadine hizalar: terminal’de ilk çalışan agent oturumu, pano eşleştirmesi veya her zaman açık runtime değil.

Güvenlik bilincine sahipseniz ve yükleyiciyi çalıştırmadan önce incelemeyi tercih ederseniz, bu alternatif yaklaşımı kullanın:

git clone https://github.com/zeroclaw-labs/zeroclaw.git
cd zeroclaw
./install.sh

Sağlayıcılar veya istemler hakkında düşünmeden önce, ikili dosyanın kabukta çağrılabilir olduğunu doğrulayın:

zeroclaw --version

Bu işe yarıyorsa, kurulum başarılı olmuştur. Kabuk command not found derse, aşağıdaki geçici PATH düzeltmesini uygulayın ve tekrar test edin:

export PATH="$HOME/.cargo/bin:$PATH"

Bu adımı yapılandırmadan ayırmak önemlidir. Çalışan bir zeroclaw –version size yükleyici sorununun sağlayıcı kurulumunu hata ayıklamaya başlamadan önce çözüldüğünü söyler.

zeroclaw onboard çalıştırın ve oluşturduğu şeyi kontrol edin

Bu, “yüklenen” öğesinin “yapılandırılan” olması gereken noktadır. Yukarıda kullanılan etkileşimsiz kurulum yolunda, komut dosyası açıkça kurulum istemini atlar. Yükleyici mesajı zeroclaw quickstart önerisinde bulunuyorsa ancak ikili dosya bunu tanımıyorsa, zeroclaw –help öğesine güvenin ve ilk çalıştırma sihirbazını şu şekilde başlatın:

zeroclaw onboard

Sihirbaz çalışma alanı ekranında açılır. Yakalanan çalışmada, varsayılan çalışma alanı yolu /root/.zeroclaw/workspace idi. Bunu taşımak için güçlü bir nedeniniz yoksa, varsayılanı kabul edin. Kök olmayan bir hesapta, aynı düzen kendi ev dizininiz altında yaşayacaktır.

Bu başlangıç CLI kılavuzu için, çok çalışma alanı profillerini devre dışı bırakın. Bunları açmak, katılım başına ayrı bellek, sırlar ve denetim dizinleri oluşturur, bu daha sonra yararlı olabilir, ancak ilk bir duman testi için ekstra zihinsel ek yük ekler.

Sağlayıcı ekranında OpenRouter öğesini seçin. Liste, bir başlangıç rehberi ihtiyaç duyduğundan çok daha büyüktür, bu tam olarak neden bir temiz barındırılan yolu seçip ilk çalıştırmada buna yapışmaya yardımcı olur.

İstendiğinde OpenRouter API anahtarınızı yapıştırın. Giriş gizlidir ve istem açıkça ZeroClaw’ın sırrı config.toml içine kodlamak yerine mümkün olduğunda OS anahtarlığı aracılığıyla depoladığını belirtir.

OpenRouter model listesi uzundur. Yakalanan çalışmada, deepseek/deepseek-v4-pro seçildi. Tercih ederseniz başka bir geçerli OpenRouter modeli seçebilirsiniz, ancak bu kılavuzun geri kalanı tam olarak bu seçimi takip eder.

Sihirbaz gelişmiş ayarlar hakkında sorduğunda, bu rehber için bunları kapalı bırakın. Bunları açmak, sıcaklık, zaman aşımı, temel URL veya tel protokolü gibi hedeflenen geçersiz kılmalar içindir.

Kanallar ekranında, Discord, Telegram, Slack veya başka herhangi bir harici yüzey eklemeden Bitti öğesini seçin. Bu, ilk doğrulamayı yalnızca CLI ile tutar. Yerel agent yolu çalıştıktan sonra daha sonra kanallar ekleyebilirsiniz.

Bellek için Vektör Araması ile SQLite (önerilir) öğesini seçin. Burada en güçlü varsayılandır çünkü her şeyi yerel tutar ve yine de hibrit arama ve gömme desteği sağlar.

Otomatik kaydetme öğesini Evet olarak ayarlı bırakın, böylece kendi istemleriniz konuşma geçmişi olarak kaydedilir. Daha sonra daha katı manuel kontrol istiyorsanız, bunu kapatabilir ve belleği yalnızca açıkça kaydedebilirsiniz.

Donanım kontrolünü devre dışı bırakın. Bu VPS kurulumu GPIO, USB’ye bağlı panoları veya hata ayıklama sondalarına ihtiyaç duymaz.

Genel tünel sağlayıcısı için bunu hiçbiri olarak tutun. Bu, bu makalenin güvenlik duruşu ile eşleşir: ilk duman testi sırasında genel maruziyeti yok.

Kişilik adımı zaten yapılandırıldığını söylediğinde, Yeniden Yapılandır? öğesini Hayır olarak bırakın. Varsayılan kişilik ilk çalıştırma doğrulaması için yeterlidir.

Burada önemli olan her sihirbaz panelini ezberlemek değildir. Önemli olan ekran görüntülerinin kanıtladığı yoldur: tek çalışma alanı, OpenRouter sağlayıcısı, gizli API anahtarı girişi, somut bir model seçimi, gelişmiş geçersiz kılmalar yok, ekstra kanallar yok, yerel SQLite belleği, otomatik kaydetme açık, donanım kapalı, genel tünel yok ve kişilik yeniden yazması yok. Bu, ~/.zeroclaw altında kullanılabilir bir ilk CLI yapılandırması üretmek için yeterinden fazladır.

Onboarding tamamlandıktan sonra, ana yapılandırma dizini ve çalışma alanının var olduğunu doğrulayın:

Onboarding çalışması temiz bir şekilde tamamlanırsa, aşağıdaki gibi yapılandırma yüklü bir mesaj ile kabuğa dönmelisiniz:

ls ~/.zeroclaw
ls ~/.zeroclaw/workspace

Yakalanan çalışmada, ~/.zeroclaw config.toml ve workspace/ içeriyordu ve çalışma alanı kendisi IDENTITY.md ve SOUL.md gösteriyordu.

Bu, ZeroClaw’ın artık yalnızca yüklü bir ikili dosya değil, çalışan bir odaya sahip olduğunu kanıtlamak için zaten yeterlidir. Bu aynı zamanda çalışma alanı benzetmesinin neden yararlı olduğunu açıklar: odanın var olduğunu, aracının içinde bağlama sahip olduğunu ve kurulumun “yükleyici bitti” ötesine geçtiğini kontrol ediyorsunuz. IDENTITY.md ve SOUL.md gibi dosyalar dekoratif değildir. Bunlar ZeroClaw’ın bu çalışma alanı içinde nasıl davranması gerektiğini anlamak için kullandığı bağlamın bir parçasıdır.

İlk canlı istemden önce, kompakt bir sağlık kontrolü çalıştırın:

zeroclaw status

zeroclaw doctor

Bu ilk CLI-yalnızca duman testi için, zeroclaw doctor tamamen temiz değilse panik yapmayın. Yakalanan çalışmada, önemli kontroller geçti: yapılandırma dosyası bulundu, openrouter sağlayıcısı geçerliydi, API anahtarı yapılandırıldı, varsayılan model ayarlandı ve çalışma alanı var ve yazılabilirdi.

Kalan uyarılar ve hatalar terminal sohbeti için kritik değildir: “yapılandırılmış kanallar yok” beklenir çünkü kılavuz kasıtlı olarak Discord, Telegram ve diğer harici kanalları atladı; AGENTS.md bulunamadı (isteğe bağlı) açıkça engelleyici değildir; daemon_state.json bulunamadı yalnızca her zaman açık daemon’un henüz çalışmadığı anlamına gelir; ve OpenRouter canlı model listeleme şikayeti, özellikle çıktı hala openrouter: 344 models bildirdiği için, sağlayıcı kurulumunun başarısız olduğunun kanıtı yerine bir sonda sınırlaması olarak daha iyi okunur.

grep -E 'default_provider|default_model|[agents.|[risk_profiles.' ~/.zeroclaw/config.toml

Buradaki başarı sinyali kozmetik değil, operasyoneldir. zeroclaw status etkin runtime özeti için en net gerçek kaynağıdır, zeroclaw doctor önemli bir şeyin kırılıp kırılmadığını söyler ve grep çıktısı mükemmel tek satırlık doğrulama yerine sağlayıcı/model ile ilgili yapılandırma girişlerine kaba bir göz olarak en iyi şekilde ele alınır. Sürüme göre kelime seçimi ve tam eşleşmelerin değişmesini bekleyin. Mükemmel bir yeşil metin duvarı arıyorsunuz değilsiniz. İlk çalıştırma engelleyicilerinin yokluğunu ve gerçek yapılandırma verilerinin varlığını arıyorsunuz.

📝 Not: config.toml API anahtarınızı düz metin olarak göstermeyebilir. Bu normal olabilir. Yakalanan onboarding çalışmasında, API anahtarı istemi açıkça sırrın mümkün olduğunda OS anahtarlığı aracılığıyla depolanacağını söyledi, bu nedenle “TOML dosyasında görünür anahtar yok” “kurulum başarısız” ile aynı şey değildir.

İlk güvenli CLI sohbetini başlatın

Yapılandırma ve çalışma alanı yerinde olduğunda, aracıyı etkileşimli modda başlatın:

zeroclaw agent

Yakalanan çalışmada, ZeroClaw yapılandırmayı yükledi, SQLite destekli belleği başlattı, etkileşimli mod başlığını yazdırdı ve > istemine düştü. Hedef gösterişli bir demo başlatmak değildir. Hedef, uçtan uca bağlantıyı, geçerli yapılandırmayı ve temellendirilmiş çalışma alanı farkındalığını bir düşük riskli adımda kanıtlamaktır. Salt okunur bir test, yazma yeteneğine sahip “bak ne yapabiliyor” isteminden bu aşamada çok daha faydalı sinyal verir.

İlk istem için bu tam kontrol listesini kullanın:

tell me your current workspace path, list the top-level files you can see there, and briefly explain what each one is for. Do not create, edit, or delete anything.

Runtime denetlenen modda olduğu için, ilk yararlı yanıt bir araç onayı gerektirebilir. Yakalanan çalışmada, ZeroClaw salt okunur bir kabuk komutu çalıştırmak için istedi: “pwd && echo “—-” && ls -la”

Bu tam olarak bu duman testi için istediğiniz komut türüdür: çalışma alanı yolunu yazdırır ve hiçbir şeyi değiştirmeden üst düzey içeriği listeler. Tek seferlik bir evet için Y ile onaylayın. Ayrıca N ile reddedebilirsiniz, ancak o zaman ajan tahminden ziyade gerçek dosya sistemi durumundan soruyu yanıtlamanın en kolay yolunu kaybederdi.

📝 Not: Onay isteminden önce seçilen OpenRouter modeli için bir maliyet izleme uyarısı da görebilirsiniz. Yakalanan çalışmada, ZeroClaw openrouter/deepseek/deepseek-v4-pro için tanımlanmış bir fiyatlandırma girişi olmadığını