ZeroClaw API maliyeti ve kurulumu: ücretsiz çalışma zamanı, özel sağlayıcılar, gerçek token maliyeti

ZeroClaw çalışma zamanının maliyeti $0'dır: açık kaynaklıdır, MIT VEYA Apache-2.0 çift lisanslıdır ve zeroclaw.com'un kendi SSS'si abonelik ve barındırılan koltuk olmadığını söyler — yalnızca kendi LLM sağlayıcınızın maliyetlerini ödersiniz veya Ollama ile yerel bir model çalıştırırsanız hiçbir şey ödemezsiniz. Projenin felsefe belgeleri bunu daha da açık söyler: "SaaS değil. Barındırılan sürüm, hesap sistemi ve faturalandırma yok." Dolayısıyla pratikte "ZeroClaw fiyatlandırması", iki farklı faturayı ifade eder — bir alias'ı yönlendirdiğiniz uç noktadaki model token'ları ve daemon'un çalıştığı makine. Her ikisi de 21 Eylül 2026'da kontrol edilmiştir.

Bunları atlarsanız iki şey size para veya zaman kaybettirecektir. ZeroClaw Labs hiçbir aylık fiyat yayımlamıyor; dolayısıyla daha önce gördüğünüz aylık bir "ZeroClaw" aboneliği başka birinin ürünüdür. Ayrıca ZeroClaw'ın kendi maliyet defteri, fiyatları elle girene kadar üçüncü taraf bir ağ geçidi için sıfır harcama bildirecektir; çünkü custom sağlayıcı yuvasının arkasında bir fiyat kataloğu bulunmuyor. Her iki konu da aşağıda ele alınıyor.

ZeroClaw fiyatlandırması: yazılımın maliyeti ve gerçekte size fatura edilenler

Son satır, bir "zeroclaw pricing" aramasının ulaşabileceği yanlış adrestir. ZeroClaw'ın README'si, github.com/zeroclaw-labs/zeroclaw adresini tek resmi depo olarak adlandırır ve ZeroClaw olduğunu iddia eden başka herhangi bir depo, kuruluş, alan adı veya paketin yetkisiz ve bağlantısız olduğunu belirtir. Arama parçalarında zeroclaw.live için ikinci bir agent başına aylık rakam dolaşıyor; bu site 21 Eylül 2026'da sayfa yerine hata döndürdü, bu nedenle rakam sayfada okunamadı ve burada özellikle yeniden yazılmadı. Ayrıca projenin kendi kullandığı alan adlarında bile pazarlama rakamlarını dikkatle ele alın: zeroclaw.dev, zeroclaw.org ve zeroclaw.net üzerindeki açılış sayfalarının tümü 3.4MB'lik bir ikili dosya tanıtırken projenin kendi felsefe sayfası, tipik bir sürüm derlemesinin yaklaşık 26 MiB olduğunu söyler. Bu, kimliğe bürünme kanıtından çok belgeler ile açılış sayfası arasındaki bir farktır — README'nin kendisi güvenlik bildirimlerini zeroclaw.dev adresindeki bir adrese yönlendirir. ZeroClaw vs OpenClaw bu tanımlama sorununu ayrıntılı olarak ele alır.

İki olgu çelişkili göründüğü için bir kapsam notu. "Faturalandırma yok" ZeroClaw çalışma zamanı için doğru, ZeroClaw Labs kuruluşu için yanlıştır: aynı GitHub kuruluşu, depo açıklamasında ön ödemeli Stripe faturalandırmasının adı geçen bir AGPL ağ geçidi olan ZeroRouter'ı yayımlar; ZeroClaw, kendi zerorouter yuvası üzerinden buna erişebilir. Bu, ZeroClaw aboneliği değil, beta aşamasındaki farklı bir üründür ve barındırılan fiyatları yayımlanmış bir fiyat listesi değil, canlı ağ geçidi durumudur.

Bugün yazılması gereken yapılandırma biçimi: düz parçacık değil, schema 3

Resmi belgeler günceldir; arama sonuçlarında bulacağınız ZeroClaw yapılandırmalarının büyük bölümü güncel değildir. Mevcut yapılandırma şeması sürümü 3'tür — v0.8.5 sürüm etiketindeki CURRENT_SCHEMA_VERSION: u32 = 3 crates/zeroclaw-config/src/migration.rs içinde bulunur ve V1'den V2'ye, V2'den V3'e bir geçiş zinciri vardır. Eski öğreticilerde dolaşan düz biçim schema 1'dir. schema_version taşımayan bir yapılandırma dosyası sürüm 1 olarak kabul edilir ve yükleme sırasında bellekte geçirilir; dolayısıyla dosya, yükleme işlemi tarafından diskte yeniden yazılmaz.

Adlandırmaya dikkat edin: "ZeroClaw V3" bir sürüm değildir. En son sürüm v0.8.5'tir; 5 Eylül 2026'da yayımlanmıştır (GitHub API, 21 Eylül 2026'da kontrol edilmiştir). schema 3, bunun içindeki yapılandırma biçimidir. İki sayı birbiriyle ilişkili değildir.

Schema-1 alan adları, v0.8.5 sürümündeki V1 geçiş merceğinden; schema-2 satırları ise master'daki V2 merceğinin belge yorumlarından okunmuştur; her ikisi de 21 Eylül 2026 tarihindendir. Bu mercekler, eski bir dosyanın geçiş sırasında hangi şema olarak ayrıştırıldığını belirler; bu yüzden eski alan adları için iyi kanıttırlar. Son satırda iki kaynak tarihe göre uyuşmaz: V2 merceği, V3'ün cost.prices alanını kaldırdığını ve fiyatlandırmayı her model sağlayıcısına satır içi taşıdığını kaydederken mevcut maliyet izleme belgeleri, alias başına satır içi pricing alanını eski olarak adlandırır ve ileriye dönük, çakışmada öncelikli yapı olarak [cost.rates.*] yapısını belirtir. [cost.rates.*] yazın.

Şema 3 kapsamında her model sağlayıcısı [providers.models.<type>.<alias>] bölümünde yer alır; burada type, kanonik aile yuvasıdır — "Her sağlayıcı için tek bir yuva vardır; eş anlamlı adlar yoktur" — ve alias adını siz belirlersiniz. Sağlayıcı genel bakışı, "genel bir 'varsayılan sağlayıcı' veya 'varsayılan model' ayarı olmadığını" açıkça belirtir ve herhangi bir başvuru çözümlenemezse Config::validate() işlevinin başlangıçta açıkça hata verdiğini söyler. Kopyalanmış bir şema-1 parçacığı eski olduğu için reddedilmez — geçiş zinciri, üst düzey api_key, api_url ve default_model alanlarını, adı default_provider anahtarıyla belirlenen bir sağlayıcı girdisinde birleştirir; V1 lens'i bu anahtar yoksa openrouter değerini kullanır. Bu nedenle yalnızca anahtar ve URL taşıyan düz bir parçacık, amaçladığınız ağ geçidi yerine bir openrouter girdisine dönüşür. Hata nedeni eski bir alan adının kullanılması değil, çözümlenemeyen bir başvurudur.

ZeroClaw özel sağlayıcısı: bir alias'ı OpenAI uyumlu API'ye yönlendirme

OpenAI chat-completions protokolünü kullanan bir uç nokta custom yuvasına eklenir ve v0.8.5'teki özel sağlayıcı sayfası, bunun yalnızca yapılandırma değişikliği olduğunu söyler: "custom yuvası uri gerektirir (ailenin uç nokta enum'unda varsayılan yoktur)." Anthropic Messages protokolünü kullanan bir uç nokta ise anthropic yuvasına eklenir ve uri geçersiz kılacak şekilde ayarlanır — custom yuvasına değil. Kunavo her iki protokol biçimini de tek bir anahtarla https://api.kunavo.com/v1 altında sunar; dolayısıyla kâğıt üzerinde her iki yuva da uygundur. Aşağıdaki kod parçası, belgelenmiş özel yuva alanlarını belgelerin kendi uygulamalı örneğindeki dört başlıklı biçimle birleştirir; bu, uyarlamadır, kopyalanmış resmi bir blok değildir.

# Four section headers is the smallest config that loads clean.
[providers.models.custom.kunavo]
uri     = "https://api.kunavo.com/v1"   # REQUIRED: the custom family has no default endpoint
model   = "claude-sonnet-4-6"
api_key = "sk-kn-..."                   # or the secrets store, op://, or a ZEROCLAW_ env override

[agents.assistant]
model_provider  = "custom.kunavo"       # there is no global default provider
risk_profile    = "supervised"
runtime_profile = "resident"

[risk_profiles.supervised]
level                            = "supervised"
workspace_only                   = true
require_approval_for_medium_risk = true
block_high_risk_commands         = true

[runtime_profiles.resident]
max_actions_per_hour   = 10             # example values from the docs, not defaults
max_cost_per_day_cents = 100
max_tool_iterations    = 4
agentic_timeout_secs   = 120

Dört pratik not. Kimlik bilgileri dört şekilde sağlanabilir: doğrudan yazılan api_key, bir 1Password op://vault/item/field referansı, ~/.zeroclaw/secrets konumundaki şifrelenmiş depo veya çift alt çizginin bir noktaya karşılık geldiği genel ortam değişkeni geçersiz kılma mekanizması ZEROCLAW_providers__models__custom__kunavo__api_key aracılığıyla. Sağlayıcı ailesinin belgelerinde kendi ortam değişkeni köprüsü açıklanmadıkça, $ANTHROPIC_API_KEY gibi ekosistemde varsayılan olarak kullanılan bir kabuk değişkeni adı doğrudan okunmaz; belgeler, bunu şemayı yansıtan ada kendiniz genişletmenizi söyler. Şemayı yansıtan bir ortam değişkeni ise çalışma zamanında enjekte edilir ve hiçbir zaman kalıcı yapılandırmaya dönüşmez. custom yuvası varsayılan olarak chat-completions iletişim biçimini kullanır. wire_api, kendi uç noktanızı kullanabildiğiniz ailelerde (openai, llamacpp, custom) dikkate alınırken, markalı sağlayıcı yuvaları sabit bir iletişim biçimine sahiptir ve bunu yok sayar; opencode tek istisna olarak belirtilir. Ağ geçidiniz bir temperature alanını reddediyorsa bu alanı ayarlamayın: belgeler, ayarlanmamış bir temperature alanının istek gövdesine hiç eklenmediğini belirtir. Ayrıca sorunsuz bir başlangıç, göründüğünden daha az şeyi kanıtlar: bağlantı hazırlığı, gövdeyi okuyup tüketen ve başarısızlık durum kodlarını da kabul eden bir GET isteğidir; bu nedenle daemon her iki durumda da başlar. master dalındaki özel sağlayıcı sayfası bunu GET {base_url}/models olarak belgelerken, v0.8.5 kodu hazırlık işlemini bunun yerine chat-completions URL'sine yönelik gerçekleştirir.

Belgelenen sırayla, üçünü de v0.8.5'te doğrulayın: zeroclaw config list yapılandırmayı yükler ve doğrulama hatalarını stderr'e yazdırır, zeroclaw models refresh --model-provider custom.kunavo uç noktanın duyurduğu şeyleri listeler ve zeroclaw agent -a assistant -m "hello" agent'ı smoke-test'ten geçirir. Kunavo'nun kendi /v1/models uç noktası anahtar olmadan HTTP 401 yanıtı verir (21 Eylül 2026'da doğrulandı); bu bir engel değildir: refresh komutu alias'ın anahtarını gönderir. Kunavo, ZeroClaw'ı çalışma zamanında test etmemiştir — bu bölümdeki her şey ZeroClaw'ın kaynak belgelerinin incelenmesine dayanır; bu nedenle rotaya güvenmeden önce kendi sınırlandırılmış görevinizi çalıştırın.

Kunavo embedding, text-to-speech veya speech-to-text modeli sunmaz; bu nedenle bu adımlara ihtiyaç duyan bir agent, sohbet modelinin hangi ZeroClaw yuvasında bulunduğundan bağımsız olarak bunları farklı bir uç noktaya yönlendirir.

Oran tablosunu yazana kadar maliyet ölçer $0 gösterir

ZeroClaw kendi harcamasını ölçer ve üçüncü taraf bir ağ geçidinde bu ölçer yanlış başlar. Maliyet izleme cost.enabled tarafından etkinleştirilir ve kayıtlar <workspace>/state/costs.jsonl yolundaki yalnızca eklemeli bir deftere, her satıra bir JSON nesnesi olacak şekilde yazılır. Sorun fiyatların nereden geldiğidir. v0.8.5'teki catalog.rs içinde catalog_source_for, custom ailesi için ne bir models.dev anahtarı ne de bir OpenRouter sağlayıcı öneki döndürür — markalı yuvaların çoğu bu ikisinden en az birini taşır, ancak birkaçında (zerorouter, telnyx, nearai) ikisi de yoktur. live_pricing seçeneği varsayılan olarak kapalıdır; açık olduğunda önce uç noktanın kendi /models listesini okur, ardından ailenin models.dev adıyla anahtarlanmış models.dev'e geri döner. custom ailesinde böyle bir anahtar yoktur; dolayısıyla bu yuvada tek kaynak uç noktanın kendi listesidir. Kunavo'nun listesinde token başına fiyat alanı bulunmaz; bu bilgi kimliği doğrulanmış bir üretim yanıtından değil, rota kaynağından okunmuştur. Bu nedenle özel yuvadaki bir takma ad için, siz oranları kendiniz girene kadar cost_usd = 0 değeriyle birlikte sıfırdan büyük bir unpriced_tokens değeri kaydedilir.

[cost]
enabled = true

# Keyed by the UPSTREAM model id as it appears in usage telemetry,
# not by your alias. USD per 1M tokens.
[cost.rates.providers.models.custom.claude-sonnet-4-6]
input        = 2.1
output       = 10.5
cached_input = 0.21

Bundan, tümü 21 Eylül 2026'da kontrol edilen maliyet izleme belgelerinden kaynaklanan üç davranış çıkar. Oran girdileri, alias'ınıza göre değil, kullanım telemetrisinde göründüğü şekliyle upstream model kimliğine göre anahtarlanır. Bütçe karşılaştırmaları kaydedilen cost_usd değerini kullanır; bu nedenle günlük veya aylık toplamın sınırın altında olması, ay içinde fiyatlandırılmamış token'lar varken bir güvenlik garantisi değildir. Mevcut defter satırları da hiçbir zaman yeniden fiyatlandırılmaz: "geriye dönük yeniden fiyatlandırma yoktur"; dolayısıyla oranlar yalnızca siz yapılandırdıktan sonra yapılan isteklere uygulanır. Uygulamanın üç modu vardır — varsayılan warn, block ve daha ucuz bir route_down_model ile değiştiren route_down — ayrıca varsayılanı false olan allow_override, bir isteğin CLI'daki geçersiz kılma token'ı ile block modunu atlamasına izin verir.

ZeroClaw'ın kendi günlük sınırına göre örnek tahmin

Bu, ölçülmüş bir görev maliyeti veya fatura üst sınırı değil, örnek amaçlı bir token hesabıdır. Belgelerde ayrıntılı olarak hesaplanan [runtime_profiles] örneği, bir ajanı max_actions_per_hour = 10 ve max_cost_per_day_cents = 100 ile sınırlar — bunlar küçük bir yerel model için örnek değerlerdir, varsayılan değerler değildir. Bu üst sınırı günde sekiz etkin saat için olduğu gibi uygulayın: günde 80 tur; her turda 6.000 önbelleğe alınmamış girdi token'ı gönderilir ve 500 çıktı token'ı döndürülür. Fiyatlar, milyon token başına güncel Kunavo kataloğu fiyatlarıdır.

Burada yararlı olan, sıralamayı değil, üst sınırla etkileşimi değerlendirmektir. Küçük bir yerel model için yazılmış profil, en ileri düzey bir modeli aynı üst sınırlara tabi tutar: max_actions_per_hour tur sayısını sınırlar ve günlük maliyet üst sınırı, yalnızca enforcement.mode block olduğunda isteği reddeder. Varsayılan mod olan warn kullanıldığında üst sınır hiçbir isteği engellemez — olayı günlüğe kaydeder ve isteğin geçmesine izin verir. (warn_at_percent, varsayılan değeri %80 olan ayrı bir ayardır: ağ geçidinin kesin sınıra ulaşılmadan önce ne zaman bir uyarı bandı göstereceğini belirler.) Daha da kötüsü, yukarıdaki fiyat tablosunu hiç yazmadıysanız bunların hiçbiri devreye girmez; çünkü üst sınır fiyatlandırılmamış token'ları göremez. Tabloyu bütçe olarak değerlendirmeden önce kendi tur sayınıza ve girdi-çıktı oranınıza göre ölçeklendirin; tablo önbellek ücretlerini, araç çağrılarını ve yeniden denemeleri içermez ve daha ucuz modelin işi ek deneme yapmadan tamamladığını varsayar.

Kunavo kataloğundaki tutar bir sınırdan çok faturalandırma tabanıdır: upstream ücretini bildirdiğinde fatura, katalog maliyeti ile upstream maliyetinin geçerli markup ile çarpımından büyük olanıdır. Minimum yükleme, bir görev ücreti veya abonelik değil, finansman minimumu olan $10 ön ödemeli kredidir — faturalandırma ayrıntılarına bakın.

ZeroClaw için en iyi model ve en iyi API: projenin size söyleyecekleri ve söylemeyecekleri

ZeroClaw önerilen bir model yayımlamaz ve bunu açıkça reddeder. Çoklu model kurulum sayfası, "bu iş akışının ZeroClaw tarafından doğrulanmış bir model listesi oluşturmadığını" ve "bir derleme, model, quantization ve context ayarı için elde edilen kanıtın diğer kombinasyonları doğrulamadığını" belirtir. "ZeroClaw için en iyi model" sorusunun dürüst yanıtı budur: atıf yapılabilecek resmi bir sıralama yoktur; bu nedenle iki test edilebilir özelliğe göre seçim yapın.

Birincisi modele yerleşik araç çağrısıdır; aynı sayfa bunun için katı bir ölçüt koyar: "Çalıştırmada gerçek bir araç çağrısı, bunun yürütülmesiyle elde edilen sonuç ve bu sonucu kullanan bir asistan devamı olup olmadığını inceleyin. Makul bir yanıt veya yalnızca yazdırılmış araç çağrısı işaretlemesi, başarılı bir araç testi değildir." Çalışma zamanı profili ayarı strict_tool_parsing, XML veya JSON'a benzeyen geri dönüş metnini sağlayıcı gerçek araç çağrıları döndürmediği sürece düz asistan metni olarak ele alır; bu nedenle yalnızca araç çağrısını açıklayan bir model çalışıyor gibi görünür ancak hiçbir zaman eyleme geçmez. İkincisi, modelin görevinizi ek deneme yapmadan tamamlayıp tamamlamadığıdır — listelenen en ucuz fiyat ile görevi tamamlamanın en düşük maliyetinin farklı iddialar olmasının nedeni budur.

Devre dışı bırakma mekanizmasını etkinleştirmeden önce bütçelemeye değer iki davranış. Akışın sözleşmesi daha dardır: provider-routing-lifecycle sayfası, sarmalayıcının "istenen akış yeteneklerini destekleyen ve soğuma sürecinde olmayan ilk sıralı girdiyi seçtiğini", ardından "bu akışı bir kez açtığını" ve "akış başladıktan sonra girdileri değiştirmediğini" söylüyor — ancak herhangi bir çıktı işlenmeden önce başarısız olan bir akış, akışsız yol üzerinden yeniden denenir; bu da fallback_models ve fallback üzerinde tam güvenilirlik taramasına yeniden girer. Bu akışsız yeniden denemeler zaman aşımını, bağlantı hatasını, 429 ve 503'ü kapsar; 400'ü, kalıcı kimlik doğrulama hatasını veya model çıktısı hatalarını açıkça kapsamaz. Ayrıca bir geri dönüş girdisi işi farklı bir fiyat katmanına taşıyabilir; bu nedenle önce ona bir bütçe ayırın. Ağ geçidi yollarının daha kapsamlı karşılaştırması için OpenAI uyumlu API kılavuzuna ve OpenRouter alternatiflerine bakın.

Sürekli işler: risk profilleri, limitler ve işi yeniden başlatan hizmet

Özerklik genel değil, ajan başınadır. v0.8.5'teki özerklik sayfası tam olarak üç düzeyi kabul eder — readonly, supervised ve full — ve yapılandırma yüklenirken alt çizgi içeren read_only değerini reddeder. Varsayılan supervised altında düşük riskli araçlar otomatik çalışır, orta riskli araçlar operatör onayı istemi gösterir ve yüksek riskli araçlar engellenir. Onay istemlerinin süresi kanalın approval_timeout_secs süresinden sonra dolar; çoğu kanal için bu süre 120 saniyedir ve zaman aşımı ret olarak sayılır — dolayısıyla başında kimse olmayan bir ajan işlemleri kuyruğa almak yerine onay yokluğunda engeller.

Sürekli işler için iki sınır vardır. Yeniden başlatma davranışı platformlar arasında aynı değildir: kurulu systemd kullanıcı birimi Restart=always ayarını RestartSec=3 ile kullanır ve çıkış kodu izin listesi içermez; bu nedenle hatalı yapılandırma nedeniyle hızlıca başarısız olan bir daemon sürekli yeniden başlatılır; macOS LaunchAgent RunAtLoad ve KeepAlive ayarlarını kullanır; Windows'ta ise zeroclaw service install, oturum açıldığında daemon'ı başlatan bir ONLOGON Task Scheduler görevi kaydeder ancak başarısızlıkta yeniden başlatma ilkesi eklemez. Zamanlanmış işler de bildirimseldir ve [cron.<alias>] bölümünde takma ad anahtarlarıyla tanımlanır; [scheduler] bölümünün kendi ayarlarından ayrıdır. Ayrıca deterministik SOP motoru, projenin kendi özellik matrisi tarafından deneysel olarak işaretlenmiştir — çevre birimi ve takvim tetikleyicileri tanımlanıp eşleştirilir, ancak henüz canlı bir kaynağa yönlendirilmez — bu nedenle henüz bunun üzerine gözetimsiz bir iş akışı tasarlamayın.

Kurun ve ilk ücreti kontrol edin

Kunavo, ZeroClaw'a özgü bir entegrasyon sayfası yayımlamamış ve istemciyi çalışma zamanında test etmemiştir; bu nedenle yukarıdaki yapılandırmayı bir uyumluluk sonucu değil, kaynak belgede açıklanan bir yol olarak değerlendirin. Uygulamadaki sıra kısadır: bir anahtar oluşturun, minimum bakiyeyi yükleyin, dört üst bilgiyi yazın, üç doğrulama komutunu sırayla çalıştırın, ardından defterin kaydedeceği bir şey olması için ilk uzun çalıştırmadan [cost.rates.*] önce bloğunu yazın. Temel URL ve anahtar biçimi için hızlı başlangıç bölümünden, custom yuvasının konuştuğu kablo protokolü için chat-completions referansından başlayın ve bir hesabı finanse etmeye hazır olduğunuzda Kunavo hesabı oluşturun. Ajanınız bunun yerine Anthropic kablosunu konuşuyorsa, Anthropic temel URL belgesi anthropic yuvası yolunu açıklar.

Sık sorulan sorular

21 Eylül 2026'da kontrol edildi. Bu sayfa için doğrudan yeniden okunanlar: zeroclaw.com SSS'si, kod deposunun README'si, depo durumu ve v0.8.5 sürümü için GitHub API'si, v0.8.5 etiketindeki migration.rs, schema/v1.rs, catalog.rs, compatible.rs, providers/custom.md, security/autonomy.md ve ops/service.md, master dalında V2 geçişine ilişkin bakış açısı, providers/overview.md, providers/configuration.md, providers/catalog.md, providers/routing.md, providers/custom.md, architecture/provider-routing-lifecycle.md, ops/cost-tracking.md, getting-started/multi-model-setup.md, philosophy/minimal.md, philosophy/what-this-isnt.md ve reference/feature-matrix.md, ayrıca zerorouter kod deposu, yukarıda adı geçen üçüncü taraf ve açılış sayfası siteleri ve Kunavo'nun /v1/models uç noktasına kimlik doğrulamasız bir GET isteği. Master'dan alıntılanan her şey geliştirme dalı belgeleridir ve kararlı sürümün önüne geçebilir. Kunavo, ZeroClaw'ı çalışma zamanında test etmemiştir: kurulum yapılmadı, config list çalıştırılmadı ve ajan çalıştırılmadı; bu nedenle bu yol üzerinden akış, modele yerleşik araç çağrısı ve görüntü yetenekleri burada doğrulanmamıştır. Kunavo belirteç ücretleri güncel katalogdan okunur ve bu sayfadaki her dolar tutarı açıklama amaçlı belirteç aritmetiğidir.