Harga dan penyiapan API PicoClaw: model, protokol, dan kunci

Perangkat lunak PicoClaw gratis: repositorinya berlisensi MIT dan FAQ milik picoclaw.io sendiri mengatakan "Perangkat lunaknya gratis. Anda hanya membayar penggunaan API LLM" — jadi "harga PicoClaw" berarti tagihan API model Anda, ditambah biaya perangkat jika ada. Sipeed tidak mengiklankan langganan PicoClaw maupun tier ter-host. Angka yang perlu dianggarkan adalah token per giliran agen, dan pengaturan yang paling mungkin mengejutkan Anda adalah batas iterasi alat PicoClaw: 50 ketika field tidak ada, 20 dalam konfigurasi contoh yang disertakan.

Dua klarifikasi terlebih dahulu, karena halaman hasil mencampuradukkannya. Domain resmi adalah picoclaw.io — domain tersebut merupakan field homepage dari github.com/sipeed/picoclaw. Situs mirip pico-claw.com menyatakan di footer-nya sendiri bahwa situs tersebut "tidak berafiliasi secara resmi dengan Sipeed atau PicoClaw", dan harga paket bulanan di sana adalah milik modul managed hosting situs itu sendiri, bukan milik PicoClaw. Situs mirip kedua, picoclaw.net, juga bukan domain resmi. Situs itu menonjolkan "95% AI-Generated Code" dan "3 Supported Architectures" — x86_64, ARM64, dan RISC-V — sedangkan FAQ di picoclaw.io mencantumkan enam. Dan PicoClaw bukan fork dari OpenClaw; PicoClaw adalah implementasi Go independen yang membenchmark dirinya terhadap OpenClaw dan NanoBot.

Harga PicoClaw, baris demi baris

Semuanya diperiksa pada 21 September 2026. Versi, sebagai catatan: rilis bertag terbaru adalah v0.3.1, diterbitkan 3 Juli 2026, sedangkan repositori terakhir didorong pada 17 September 2026 — jadi kode di main lebih baru daripada tag tersebut, dan daftar berita README sendiri bahkan lebih usang, dengan entri rilis terbaru v0.2.9 pada 28 Mei 2026. Setiap perilaku di bawah ini dibaca pada main, bukan dari biner v0.3.1 yang akan Anda unduh; pembaca pada rilis bertag mungkin melihat hal yang berbeda. Satu kondisi langsung pada tanggal pemeriksaan: sertifikat TLS untuk picoclaw.io telah kedaluwarsa (berlaku 25 Februari hingga 10 September 2026), sehingga browser menampilkan peringatan keamanan pada halaman unduhan resmi. Hal itu dapat diperbaiki kapan saja dan tidak menunjukkan apa pun tentang proyek tersebut; GitHub Releases tidak terpengaruh.

Penyiapan kunci API PicoClaw: model_list dan .security.yml

picoclaw onboard membuat ~/.picoclaw/config.json dan workspace. Model dideklarasikan dalam array model_list dan dipilih berdasarkan nama dari agents.defaults.model_name; keduanya harus cocok, yang merupakan satu-satunya kasus yang dibahas dalam dokumen pemecahan masalah PicoClaw.

{
  "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
    }
  ]
}

Kunci berada dalam file kedua. Dokumentasi keamanan PicoClaw menyebut config.json sebagai "Konfigurasi utama (aman untuk dibagikan)" dan .security.yml sebagai "Data keamanan (jangan pernah dibagikan)", serta meminta Anda menjalankan chmod 600 padanya. Bentuk YAML adalah map yang dikunci berdasarkan model_name, bukan array yang digunakan dalam config.json, dan api_keys berbentuk jamak serta berupa array bahkan untuk satu kunci.

# 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-..."

Empat detail yang sering menjebak orang. provider bersifat opsional: jika diatur, model dikirim ke upstream tanpa perubahan; jika dihilangkan, PicoClaw membaca segala sesuatu sebelum / pertama dalam model sebagai provider, yang merupakan bentuk protocol/model lama. Config memiliki versi schema dan version 3 adalah versi saat ini; migrasi menulis cadangan bertanggal, dan dokumentasi memperingatkan bahwa file V3 tidak dapat dimuat dengan aman oleh build lama yang hanya mendukung V2. Selama migrasi V1 ke V2, enabled disimpulkan otomatis — entri tanpa kunci API dan yang tidak bernama local-model secara default menjadi disabled — itulah sebabnya contoh di atas menetapkan enabled secara eksplisit setelah kunci dipindahkan ke .security.yml. Dan streaming secara default nonaktif serta dikendalikan dua kali: streaming.enabled pada entri model dan settings.streaming.enabled pada channel harus sama-sama true.

Satu batasan yang perlu disebutkan sebelum Anda menulis entri: tabel vendor PicoClaw mencantumkan Groq sebagai "LLM + Voice transcription (Whisper)", dan Kunavo tidak menyediakan speech-to-text, text-to-speech, atau embeddings — entri transkripsi atau embedding harus menunjuk ke provider lain, dan hanya entri chat yang dapat menggunakan kunci Kunavo.

Nama protokolnya terbalik, dan itulah seluruh jebakannya

Di PicoClaw, anthropic berarti model berbentuk Claude melalui format wire OpenAI, sedangkan anthropic-messages berarti Anthropic Messages API native. Dokumentasinya menyatakannya secara langsung: "Protokol anthropic menggunakan format yang kompatibel dengan OpenAI (/v1/chat/completions), sedangkan anthropic-messages menggunakan format native Anthropic (/v1/messages)." Source-nya sesuai — factory_provider.go membangun provider HTTP yang kompatibel dengan OpenAI bersama untuk anthropic dan provider native terpisah untuk anthropic-messages. Tabel "All Supported Vendors" PicoClaw sendiri bertentangan dengan keduanya dengan memberi label "Anthropic" pada kolom protokol baris anthropic; pembaca yang hanya membaca tabel tersebut akan mengonfigurasi protokol yang salah.

Dibaca dari openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go dan factory_provider.go pada main, 21 September 2026 — diturunkan dari kode, bukan diamati pada wire. Konsekuensinya konkret: Anda tidak dapat mengarahkan anthropic atau anthropic-messages ke gateway yang path-nya tidak boleh berakhir dengan /v1, karena PicoClaw selalu menambahkannya. Gateway di https://gw.example.com/anthropic menjadi https://gw.example.com/anthropic/v1/messages. Untuk endpoint seperti itu, protokol openai, yang menghormati path secara verbatim, adalah satu-satunya yang dapat menyatakan URL tersebut. Hanya tiga protokol ini yang diaudit; jangan menggeneralisasi aturan ini ke gemini, azure, atau yang lainnya.

Ada dua batasan tambahan pada jalur native, keduanya ditemukan saat membaca file yang sama. anthropic-messages memerlukan kunci API dan langsung menghasilkan kesalahan jika kunci tidak tersedia, sehingga cabang OAuth — yang dihubungkan oleh factory_provider.go ke anthropic dan openai, bersama jembatan CLI dan antigravity — tidak dapat diakses melalui jalur tersebut. Selain itu, meskipun lima cabang di factory_provider.go meneruskan cfg.CustomHeaders, cabang anthropic-messages bukan salah satunya: konstruktornya hanya menerima kunci, URL dasar, user agent, dan batas waktu. Jadi, opsi alternatif custom_headers yang didokumentasikan untuk gateway dengan autentikasi nonstandar tampaknya dapat digunakan pada protokol yang kompatibel dengan OpenAI, tetapi tidak pada protokol Messages native. Ini merupakan hasil pembacaan kode sumber, bukan pengujian saat runtime. Yang tidak hilang saat Anda menggunakan jalur native adalah kemampuan pemanggilan alat: jalur ini membangun tools native dengan input_schema serta menangani blok tool_use dan tool_result.

Untuk Kunavo, dua base URL yang didokumentasikan adalah https://api.kunavo.com/v1 untuk chat completions dan https://api.kunavo.com/v1/messages untuk rute Messages, dan handler Messages Kunavo membaca kunci dari x-api-key maupun Authorization: Bearer. Secara teori, keduanya memenuhi perhitungan URL PicoClaw dari kedua arah. Itu adalah perhitungan atas dua set dokumentasi — tidak ada permintaan PicoClaw yang dikirim ke Kunavo di sini, dan halaman ini tidak menyatakan bahwa protokol PicoClaw mana pun telah diuji terhadapnya. Lihat dokumen base URL Anthropic dan dokumen endpoint chat untuk bentuk yang tepat, lalu kirim satu permintaan terbatas sendiri.

Estimasi biaya API PicoClaw dengan contoh

Ini adalah perhitungan token ilustratif, bukan biaya tugas yang diukur dan bukan batas maksimum tagihan. Anggap satu giliran agen yang selesai dalam 8 putaran alat, dengan setiap putaran mengirim ulang transkrip yang rata-rata berisi 12.000 token input dan mengembalikan 700 token output. Rasio tersebut adalah asumsi untuk ilustrasi. Kolom kedua menjalankan bentuk yang sama hingga default bawaan max_tool_iterations sebesar 50 dalam pkg/config/defaults.go, yang berlaku ketika field tidak ada — config/config.example.json yang disertakan menulis 20, jadi baca file Anda sendiri sebelum menganggap 50 sebagai batas Anda. Tarif yang digunakan adalah harga terkini dalam katalog Kunavo per juta token.

Baca kedua kolom sebagai satu fakta. Peralihan dari 8 putaran ke batas 50 putaran mengalikan setiap baris dengan faktor 6,25x yang sama, karena panjang loop tidak bergantung pada tarif: satu giliran Claude Sonnet 4.6 berharga $0,260 pada 8 putaran dan $1,627 pada batas tersebut, sedangkan Claude Haiku 4.5 pada batas yang sama berharga $0,542. Jadi batasi max_tool_iterations pada angka yang benar-benar telah Anda amati sebelum mencari tarif yang lebih murah — pengaturan tersebut berada di bawah agents.defaults dan dapat ditimpa oleh variabel lingkungan PICOCLAW_AGENTS_DEFAULTS_MAX_TOOL_ITERATIONS. Kemudian kalikan dengan jumlah giliran per hari.

Jumlah katalog Kunavo adalah batas bawah penagihan, bukan batas atas: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream dikalikan markup yang berlaku. Pembacaan dan penulisan cache ditagihkan dengan tarifnya sendiri dan tidak dimodelkan di sini dalam arah mana pun, dan panggilan alat eksternal juga berada di luar contoh. Top-up minimum adalah $10 dalam kredit prabayar, yaitu minimum pendanaan, bukan biaya tugas atau langganan — lihat detail penagihan dan optimasi biaya AI untuk metode pengukurannya.

API terbaik untuk PicoClaw: rute mana yang unggul dan kapan

Jumlah provider bukan sumbu perbandingan di sini: kumpulan file PicoClaw sendiri tidak konsisten mengenai provider yang tersedia, jadi frasa README "30+ LLM providers" adalah hal paling aman untuk diulang. Untuk posisi PicoClaw di antara agen biner tunggal lainnya, direktori API agen AI mencantumkan permukaan konfigurasinya di samping milik mereka, dan alternatif OpenRouter membandingkan rute gateway berdasarkan ketentuan pendanaan, bukan kedalaman integrasi.

Permintaan pertama, putaran alat pertama, dan 404

Jalankan satu tugas terbatas dan baca tiga hal secara berurutan. Error model tidak ditemukan dalam model_list adalah kasus yang didokumentasikan dan merupakan ketidakcocokan nama: agents.defaults.model_name harus sama dengan entri model_name, dan ID tanpa prefiks tanpa provider yang ditetapkan tidak memilih vendor yang Anda maksud — ID tersebut kembali ke protokol openai, yang merupakan kasus "model": "free" terdokumentasi ketika OpenRouter menerima ID literal free dan menolaknya. 404 pada permintaan pertama adalah sinyal terdokumentasi bahwa Anda memilih protokol Anthropic yang salah — panduan PicoClaw sendiri menyatakan untuk beralih ke anthropic-messages ketika "protokol anthropic yang ada mengembalikan error 404 (yang menunjukkan endpoint tidak mendukung format yang kompatibel dengan OpenAI)". Periksa URL yang dirakit terhadap tabel di atas sebelum mengubah hal lain; tidak ada entri pemecahan masalah resmi untuk ini, jadi diagnosis tersebut berasal dari catatan provider dan source, bukan dari halaman dukungan. Ketiga, jika putaran alat pertama gagal sementara chat biasa berhasil, curigai keketatan schema, bukan autentikasi: PicoClaw meneruskan schema alat tanpa perubahan secara default, dan tool_schema_transform: "simple" adalah opsi per model untuk endpoint yang menolak $ref, $defs, anyOf, oneOf, allOf, atau pattern.

Kunavo tidak menerbitkan halaman penyiapan PicoClaw dan belum melakukan uji kompatibilitas PicoClaw; pertahankan rute yang berfungsi saat Anda mencobanya, lalu baca biaya yang benar-benar dicatat oleh akun Anda untuk tugas tersebut, bukan memperkirakannya dari halaman ini. Buat akun Kunavo saat Anda siap mengisi saldo kunci, dan bandingkan tarif model di API Claude termurah jika Claude adalah keluarga model yang sudah Anda pilih.

Pertanyaan umum

Diperiksa pada 21 September 2026: repositori GitHub dan API rilis, picoclaw.io (dibaca dengan validasi sertifikat dinonaktifkan karena sertifikatnya telah kedaluwarsa), 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, dan tujuh file sumber di branch main — factory_provider.go, openai_compat/provider.go, common/anthropic_common.go, anthropic_messages/provider.go, provider_metadata.go, pkg/config/defaults.go dan pkg/config/config.go — serta dua domain yang namanya mirip. Yang tidak diperiksa: kuota pihak ketiga dalam tabel perbandingan PicoClaw sendiri, harga perangkat keras ritel, dan catatan rilis v0.3.1. Tidak ada yang diinstal atau dijalankan: tidak ada permintaan PicoClaw yang dikirim ke endpoint mana pun. Tarif token Kunavo berasal dari katalog langsung, dan setiap contoh dolar di sini adalah perhitungan token ilustratif, bukan biaya tugas yang diukur.