PicoClaw fiyatlandırması ve API kurulumu: modeller, protokoller ve anahtarlar

PicoClaw yazılımı ücretsizdir: depo MIT lisanslıdır ve picoclaw.io'nun kendi SSS bölümünde "Yazılım ücretsizdir. Yalnızca LLM API kullanım ücretini ödersiniz" denir; dolayısıyla "PicoClaw fiyatlandırması" model API faturanızı ve cihaz maliyetini ifade eder. Sipeed, PicoClaw için abonelik veya barındırılan katman sunmamaktadır. Bütçelenmesi gereken tutar, aracı turu başına token sayısıdır; sizi en çok şaşırtabilecek ayar ise PicoClaw'un araç yineleme sınırıdır: alan yoksa 50, dağıtılan örnek yapılandırmada 20.

Önce iki ayrımı netleştirelim; çünkü sonuç sayfası bunları birbirine karıştırıyor. Resmî alan adı picoclaw.io'dur — github.com/sipeed/picoclaw deposunun homepage alanında yer alır. Benzer görünen pico-claw.com, kendi altbilgisinde "Sipeed veya PicoClaw ile resmî bir bağlantısı yoktur" ifadesini kullanır; buradaki aylık paket fiyatı PicoClaw'a değil, bu sitenin kendi yönetilen barındırma modülüne aittir. İkinci benzer alan adı picoclaw.net de resmî alan adı değildir. "%95 Yapay Zekâ Tarafından Üretilen Kod" ve x86_64, ARM64 ile RISC-V olmak üzere "3 Desteklenen Mimari" başlıklarını kullanır; oysa picoclaw.io'daki SSS bölümü altı mimari listeler. Ayrıca PicoClaw, OpenClaw'un bir çatallaması değildir; kendisini OpenClaw ve NanoBot ile kıyaslayan bağımsız bir Go uygulamasıdır.

PicoClaw fiyatlandırması, satır satır

Tümü 21 Eylül 2026'da kontrol edildi. Kayıt için sürüm: etiketlenmiş en son sürüm 3 Temmuz 2026'da yayımlanan v0.3.1; depo ise en son 17 Eylül 2026'da gönderildi — yani main üzerindeki kod etiketten ileridedir ve README'nin kendi haber listesi daha da eskidir; en yeni sürüm kaydı 28 Mayıs 2026 tarihli v0.2.9'dur. Aşağıdaki tüm davranışlar v0.3.1 ikili dosyasından değil, main üzerinden okundu; bu nedenle etiketlenmiş sürümü indiren bir okuyucu farklı bir sonuç görebilir. Kontrol tarihinde geçerli olan bir durum: picoclaw.io TLS sertifikasının süresi dolmuştu (25 Şubat–10 Eylül 2026 tarihleri arasında geçerliydi); bu nedenle tarayıcı resmî indirme sayfasında güvenlik uyarısı gösterir. Bu durum her an düzeltilebilir ve proje hakkında hiçbir şey söylemez; GitHub Releases etkilenmemiştir.

PicoClaw API anahtarı kurulumu: model_list ve .security.yml

picoclaw onboard ~/.picoclaw/config.json ve çalışma alanını oluşturur. Modeller bir model_list dizisinde tanımlanır ve agents.defaults.model_name üzerinden ada göre seçilir; ikisinin eşleşmesi gerekir. PicoClaw'un sorun giderme belgesinin ele aldığı tek durum budur.

{
  "agents": {
    "defaults": {
      "model_name": "gateway-sonnet"
    }
  },
  "model_list": [
    {
      "model_name": "gateway-sonnet",
      "provider": "openai",
      "model": "claude-sonnet-4-6",
      "api_base": "https://api.kunavo.com/v1",
      "enabled": true
    }
  ]
}

Anahtarlar ikinci bir dosyada bulunur. PicoClaw'un güvenlik belgeleri config.json dosyasını "Ana yapılandırma (paylaşılması güvenli)" ve .security.yml dosyasını "Güvenlik verileri (asla paylaşmayın)" olarak adlandırır ve bunu chmod 600 yapmanızı söyler. YAML yapısı, config.json'da kullanılan dizi değil, model_name ile anahtarlanmış bir eşlemedir; ayrıca api_keys çoğuldur ve tek bir anahtar için bile bir dizidir.

# The map key must equal the model_name in config.json.
# api_keys is plural and is an array even for one key.
model_list:
  gateway-sonnet:
    api_keys:
      - "sk-kn-..."

İnsanları yakalayan dört ayrıntı var. provider isteğe bağlıdır: ayarlarsanız model değiştirilmeden üst akışa gönderilir; çıkarırsanız PicoClaw, model içindeki ilk / karakterinden önceki her şeyi sağlayıcı olarak okur; bu, eski protocol/model biçimidir. Yapılandırma şema sürümlüdür ve güncel sürüm 3'tür; geçiş, tarih damgalı bir yedek oluşturur ve belgeler V3 dosyasının yalnızca V2'yi destekleyen eski derlemeler tarafından güvenle yüklenemeyeceği konusunda uyarır. V1'den V2'ye geçiş sırasında enabled otomatik olarak çıkarılır — API anahtarı olmayan ve adı local-model olmayan girdiler varsayılan olarak devre dışı olur — bu nedenle yukarıdaki örnek, anahtarlar .security.yml dosyasına taşındıktan sonra enabled değerini açıkça ayarlar. Akış da varsayılan olarak kapalıdır ve iki kez denetlenir: model girdisindeki streaming.enabled ile kanaldaki settings.streaming.enabled değerlerinin ikisi de true olmalıdır.

Bir giriş yazmadan önce belirtilmesi gereken sınır: PicoClaw'un sağlayıcı tablosunda Groq, "LLM + Ses transkripsiyonu (Whisper)" olarak listelenir; Kunavo ise konuşmadan metne, metinden konuşmaya veya gömme hizmeti sunmaz. Bu nedenle bir transkripsiyon veya gömme girdisi başka bir sağlayıcıya yönlendirilmelidir ve yalnızca sohbet girdileri Kunavo anahtarı için adaydır.

Protokol adları ters çevrilmiş; bütün tuzak bundan ibaret

PicoClaw'da anthropic Claude biçimli modelleri OpenAI iletişim biçimi üzerinden, anthropic-messages ise Anthropic'in kendi Messages API'sini ifade eder. Belgelerde bu açıkça yazılıdır: "anthropic protokolü OpenAI uyumlu biçimi (/v1/chat/completions) kullanırken anthropic-messages protokolü Anthropic'in kendi biçimini (/v1/messages) kullanır." Kaynak da bunu doğrular — factory_provider.go, anthropic için ortak OpenAI uyumlu HTTP sağlayıcısını ve anthropic-messages için ayrı bir yerleşik sağlayıcıyı oluşturur. Ancak PicoClaw'un kendi "Desteklenen Tüm Sağlayıcılar" tablosu, anthropic satırının protokol sütununu "Anthropic" olarak etiketleyerek her ikisiyle de çelişir; yalnızca bu tabloyu okuyan bir kişi yanlış olanı yapılandırır.

21 Eylül 2026'da main dalındaki openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go ve factory_provider.go dosyaları incelendi — sonuçlar ağ trafiğinde gözlemlenmedi, koddan türetildi. Sonuç somuttur: PicoClaw bunu ne olursa olsun eklediği için anthropic veya anthropic-messages protokolünü, yolu /v1 ile bitmemesi gereken bir ağ geçidine yönlendiremezsiniz. https://gw.example.com/anthropic adresindeki bir ağ geçidi https://gw.example.com/anthropic/v1/messages adresine dönüşür. Böyle bir uç nokta için, yolu olduğu gibi koruyan openai protokolü URL'yi ifade edebilen tek protokoldür. Yalnızca bu üç protokol denetlendi; kuralı gemini, azure veya diğerlerine genellemeyin.

Aynı dosyada görülen, Anthropic'in kendi Messages yolu için iki ek sınırlama vardır. anthropic-messages bir API anahtarı gerektirir ve anahtar olmadan kesin hata verir; bu nedenle factory_provider.go dosyasının anthropic ve openai sağlayıcılarına, CLI köprülerine ve antigravity sağlayıcısına bağladığı OAuth dalına buradan ulaşılamaz. Ayrıca factory_provider.go dosyasındaki beş dal cfg.CustomHeaders alanını iletirken anthropic-messages dalı bunlardan biri değildir: oluşturucusu yalnızca anahtarı, temel URL'yi, kullanıcı aracısını ve zaman aşımını alır. Bu nedenle standart dışı kimlik doğrulamaya sahip bir ağ geçidi için belgelenen custom_headers kaçış yolunun OpenAI uyumlu protokollere ulaştığı, Anthropic'in kendi Messages protokolüne ise ulaşmadığı görülür. Bu, çalışma zamanı testi değil, kaynak okumasıdır. Anthropic'in kendi Messages yolunun size kaybettirmediği özellik araç çağrısıdır: Anthropic'e özgü tools yapısını input_schema ile oluşturur ve tool_use ile tool_result bloklarını işler.

Kunavo için belgelenen iki temel URL, sohbet tamamlamaları için https://api.kunavo.com/v1, Messages rotası için https://api.kunavo.com/v1/messages olarak verilir; Kunavo'nun Messages işleyicisi anahtarı hem x-api-key başlığından hem de Authorization: Bearer başlığından okur. Kâğıt üzerinde bunlar PicoClaw'un URL hesaplamasıyla iki yönden de uyuşur. Bu, iki dokümantasyon kümesi üzerinde yapılan bir hesaplamadır — burada Kunavo'ya hiçbir PicoClaw isteği gönderilmemiştir ve bu sayfa hiçbir PicoClaw protokolünün Kunavo üzerinde test edildiğini iddia etmez. Kesin biçimler için Anthropic temel URL belgesine ve sohbet uç noktası belgesine bakın, ardından kendiniz sınırlandırılmış tek bir istek gönderin.

PicoClaw API maliyeti için örnek hesap

Bunlar ölçülmüş görev maliyetleri veya fatura tavanı değil, açıklayıcı token hesaplamalarıdır. Bir aracı turunun 8 araç turunda tamamlandığını varsayalım; her turda ortalama 12.000 giriş tokenı içeren bir transkript yeniden gönderiliyor ve 700 çıkış tokenı döndürülüyor. Bu oranlar yalnızca örnek amaçlı varsayımlardır. İkinci sütun, aynı hesaplama düzenini pkg/config/defaults.go dosyasında max_tool_iterations için derlenmiş varsayılan değer olan 50 tura kadar uygular; bu değer alan bulunmadığında geçerlidir — dağıtılan config/config.example.json ise 20 yazar, bu nedenle 50'yi tavanınız kabul etmeden önce kendi dosyanızı okuyun. Ücretler, milyon token başına güncel Kunavo kataloğu fiyatlarıdır.

İki sütunu tek bir gerçek olarak okuyun. 8 turdan 50 turluk tavana çıkmak her satırı aynı 6,25x oranında çarpar; çünkü döngü uzunluğu ücretten bağımsızdır: bir Claude Sonnet 4.6 turu 8 turda $0,260, tavanda ise $1,627; aynı tavanda Claude Haiku 4.5 ise $0,542 tutarındadır. Bu nedenle daha ucuz bir ücret aramadan önce max_tool_iterations değerini gerçekten gözlemlediğiniz bir sayıyla sınırlayın — bu değer agents.defaults altında bulunur ve PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS ortam değişkeniyle geçersiz kılınabilir. Ardından günlük tur sayısıyla ölçekleyin.

Kunavo kataloğundaki tutar, bir tavan değil faturalandırma tabanıdır: üst akış kendi ücretini bildirdiğinde fatura, katalog maliyeti ile üst akış maliyetinin geçerli işaretleme katsayısıyla çarpımından büyük olanıdır. Önbellek okumaları ve yazmaları kendi oranları üzerinden faturalandırılır ve burada hiçbir yönde modellenmemiştir; harici araç çağrıları da örneğin dışındadır. Minimum yükleme, ön ödemeli kredide $10 tutarındadır; bu bir görev ücreti veya abonelik değil, finansman minimumudur — ölçüm yöntemi için faturalandırma ayrıntılarına ve AI maliyet optimizasyonuna bakın.

PicoClaw için en iyi API: hangi durumda hangi rota kazanır

Sağlayıcı sayıları burada bir karşılaştırma ekseni değildir: PicoClaw'un kendi dosya kümesi hangi sağlayıcıların bulunduğu konusunda kendi içinde çelişir; bu nedenle README'deki "30'dan fazla LLM sağlayıcısı" ifadesi tekrarlanabilecek en güvenli ifadedir. PicoClaw'un diğer tek ikili dosyalı aracılar arasındaki konumu için AI aracı API dizini, yapılandırma yüzeyini diğerlerininkiyle yan yana listeler; OpenRouter alternatifleri ise ağ geçidi rotalarını entegrasyon derinliğine göre değil, finansman koşullarına göre karşılaştırır.

İlk istek, ilk araç turu ve 404

Sınırları belirlenmiş tek bir görev çalıştırın ve üç şeyi sırayla inceleyin. model_list içinde model bulunamadı hatası, belgelerde açıklanan durumdur ve bir adlandırma uyuşmazlığından kaynaklanır: agents.defaults.model_name, bir model_name girdisiyle aynı olmalıdır; provider ayarlanmamışken öneksiz bir kimlik kullanmak, amaçladığınız sağlayıcıyı seçmez — bunun yerine openai protokolüne geri döner. Bu, OpenRouter'ın free kimliğini olduğu gibi alıp reddettiği, belgelerde açıklanan "model": "free" durumudur. İlk istekte 404 alınması, yanlış Anthropic protokolünü seçtiğinizi gösteren ve belgelerde açıklanan işarettir — PicoClaw'ın kendi rehberi, "mevcut anthropic protokolü 404 hataları döndürdüğünde (bu, uç noktanın OpenAI uyumlu biçimi desteklemediğini gösterir)" anthropic-messages protokolüne geçilmesini söyler. Başka bir şeyi değiştirmeden önce oluşturulan URL'yi yukarıdaki tabloyla karşılaştırın; bunun için resmî bir sorun giderme kaydı yoktur, dolayısıyla bu teşhis bir destek sayfasına değil, sağlayıcılara ilişkin nota ve kaynak koda dayanır. Üçüncü olarak, normal sohbet çalıştığı hâlde ilk araç turu başarısız olursa kimlik doğrulamasından ziyade şema katılığından şüphelenin: PicoClaw, varsayılan olarak araç şemalarını değiştirmeden iletir; tool_schema_transform: "simple" ise $ref, $defs, anyOf, oneOf, allOf veya pattern öğelerini reddeden uç noktalar için bu davranışı model bazında devre dışı bırakma ayarıdır.

Kunavo, PicoClaw kurulumu için bir sayfa yayımlamamış ve hiçbir PicoClaw uyumluluk testi çalıştırmamıştır; denerken çalışan bir rotayı kullanılabilir durumda tutun, ardından bu sayfadaki tahmin yerine hesabınızın o görev için gerçekten kaydettiği ücreti okuyun. Bir anahtara fon sağlamaya hazır olduğunuzda Kunavo hesabı oluşturun ve kararınızı verdiğiniz aile Claude ise model oranlarını en ucuz Claude API sayfasında karşılaştırın.

Sık sorulan sorular

21 Eylül 2026'da kontrol edildi: GitHub deposu ve releases API'si, sertifikasının süresi dolduğu için sertifika doğrulaması devre dışı bırakılarak okunan picoclaw.io, README, docs/guides/providers.md, docs/security/security_configuration.md, docs/reference/config-versioning.md, docs/guides/configuration.md, docs/operations/troubleshooting.md, config/config.example.json ve main dalındaki yedi kaynak dosyası — factory_provider.go, openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go, provider_metadata.go, pkg/config/defaults.go ve pkg/config/config.go — ayrıca iki benzer alan adı. Kontrol edilmeyenler: PicoClaw'un kendi karşılaştırma tablosundaki üçüncü taraf kotaları, perakende donanım fiyatları ve v0.3.1 sürüm notları. Hiçbir şey kurulmadı veya çalıştırılmadı: hiçbir uç noktaya PicoClaw isteği gönderilmedi. Kunavo token oranları güncel katalogdan alınmıştır ve buradaki her dolar örneği, ölçülmüş görev maliyetinden ziyade açıklayıcı token hesabıdır.