Biaya dan penyiapan ZeroClaw API: runtime gratis, provider kustom, biaya token sebenarnya

Runtime ZeroClaw berbiaya $0: runtime ini bersumber terbuka, berlisensi ganda MIT OR Apache-2.0, dan FAQ milik zeroclaw.com menyatakan bahwa tidak ada langganan maupun seat ter-hosting — Anda hanya membayar biaya penyedia LLM Anda sendiri, atau tidak membayar sama sekali jika menjalankan model lokal dengan Ollama. Dokumentasi filosofi proyek tersebut bahkan lebih tegas: "Bukan SaaS. Tidak ada versi ter-hosting, sistem akun, atau penagihan." Jadi "harga ZeroClaw" dalam praktiknya berarti dua tagihan lain — token model pada endpoint mana pun yang Anda tuju dengan sebuah alias, dan mesin tempat daemon berjalan. Keduanya diperiksa pada 21 September 2026.

Dua hal akan menghabiskan uang atau waktu Anda jika dilewati. ZeroClaw Labs sama sekali tidak menerbitkan harga bulanan, jadi langganan bulanan "ZeroClaw" yang sudah Anda lihat adalah produk milik pihak lain. Dan ledger biaya ZeroClaw sendiri akan melaporkan pengeluaran nol pada gateway pihak ketiga sampai Anda memasukkan tarif secara manual, karena slot penyedia custom tidak memiliki katalog harga di belakangnya. Keduanya dibahas di bawah.

Harga ZeroClaw: biaya perangkat lunaknya dan apa yang sebenarnya ditagihkan kepada Anda

Baris terakhir adalah tujuan yang keliru yang dapat ditemukan oleh pencarian "zeroclaw pricing". README ZeroClaw menyebut github.com/zeroclaw-labs/zeroclaw sebagai satu-satunya repositori resmi dan menyatakan bahwa repositori, organisasi, domain, atau paket lain yang mengaku sebagai ZeroClaw tidak berwenang dan tidak berafiliasi. Angka bulanan per agen kedua beredar dalam cuplikan pencarian untuk zeroclaw.live; situs tersebut mengembalikan error, bukan halaman, pada 21 September 2026, sehingga angkanya tidak dapat dibaca dari halaman dan sengaja tidak dicetak ulang di sini. Secara terpisah, perlakukan angka pemasaran dengan hati-hati bahkan pada domain yang digunakan proyek itu sendiri: halaman landing di zeroclaw.dev, zeroclaw.org, dan zeroclaw.net semuanya mengiklankan binary 3.4MB, sedangkan halaman filosofi milik proyek menyatakan bahwa build rilis tipikal berukuran sekitar 26 MiB. Itu adalah kesenjangan antara dokumentasi dan halaman landing, bukan bukti impersonasi — README itu sendiri mengarahkan laporan keamanan ke alamat di zeroclaw.dev. ZeroClaw vs OpenClaw membahas masalah identifikasi tersebut secara mendetail.

Satu catatan tentang cakupan, karena kedua fakta tersebut tampak bertentangan. "Tidak ada penagihan" berlaku untuk runtime ZeroClaw dan tidak berlaku untuk ZeroClaw Labs sebagai organisasi: organisasi GitHub yang sama menerbitkan ZeroRouter, gateway AGPL yang deskripsi repositorinya menyebut penagihan Stripe prabayar, yang dapat dijangkau dari ZeroClaw melalui slot zerorouter miliknya sendiri. Ini adalah produk berbeda dalam versi beta, bukan langganan ZeroClaw, dan harga ter-hostingnya adalah keadaan gateway live, bukan daftar harga yang diterbitkan.

Bentuk konfigurasi yang harus ditulis hari ini: schema 3, bukan cuplikan datar

Dokumentasi resmi saat ini berlaku; banyak konfigurasi ZeroClaw yang Anda temukan di hasil pencarian sudah tidak berlaku. Versi schema konfigurasi saat ini adalah 3 — CURRENT_SCHEMA_VERSION: u32 = 3 di crates/zeroclaw-config/src/migration.rs pada tag rilis v0.8.5, dengan rantai migrasi dari V1 ke V2 ke V3. Bentuk datar yang beredar dalam tutorial lama adalah schema 1. File konfigurasi tanpa schema_version diperlakukan sebagai versi 1 dan dimigrasikan di memori saat dimuat, sehingga file di disk tidak ditulis ulang oleh proses pemuatan itu sendiri.

Perhatikan penamaannya: "ZeroClaw V3" bukanlah sebuah rilis. Rilis terbaru adalah v0.8.5, diterbitkan pada 5 September 2026 (GitHub API, diperiksa pada 21 September 2026); schema 3 adalah format konfigurasi di dalamnya. Kedua angka tersebut tidak berkaitan.

Nama field Schema-1 yang dibaca dari lensa migrasi V1 pada v0.8.5; baris schema-2 berasal dari komentar dokumentasi pada lensa V2 di master, keduanya pada 21 September 2026. Lensa-lensa tersebut adalah cara file lama diuraikan sebagai bagian dari migrasi, sehingga menjadi bukti yang baik untuk nama field lama. Pada baris terakhir, dua sumber berbeda berdasarkan tanggal: lensa V2 mencatat bahwa V3 menghapus cost.prices dan memindahkan penetapan harga secara inline ke setiap penyedia model, sedangkan dokumentasi pelacakan biaya saat ini menyebut field inline per-alias pricing sebagai legacy dan menamai [cost.rates.*] sebagai permukaan yang berorientasi ke depan dan menang saat terjadi konflik. Tulis [cost.rates.*].

Dalam schema 3, setiap penyedia model berada di [providers.models.<type>.<alias>], dengan type sebagai slot keluarga kanonis — "Ada satu slot per vendor, tanpa sinonim" — dan alias adalah nama yang Anda tentukan. Ikhtisar penyedia secara eksplisit menyatakan bahwa "tidak ada pengaturan 'penyedia default' atau 'model default' global", dan bahwa Config::validate() gagal secara jelas saat startup jika referensi apa pun tidak dapat di-resolve. Cuplikan schema-1 yang disalin tidak ditolak karena sudah lama — rantai migrasi memasukkan api_key, api_url, dan default_model tingkat teratasnya ke dalam entri penyedia bernama default_provider, dan lensa V1 mengganti dengan openrouter jika kunci tersebut tidak ada, sehingga cuplikan datar yang hanya memuat kunci dan URL berakhir pada entri openrouter, bukan gateway yang Anda maksud. Mode kegagalannya adalah referensi yang tidak dapat di-resolve, bukan nama field lama.

Penyedia custom ZeroClaw: mengarahkan alias ke API yang kompatibel dengan OpenAI

Endpoint yang menggunakan chat-completions OpenAI ditempatkan pada slot custom, dan halaman custom-provider pada v0.8.5 menyatakan bahwa ini adalah perubahan khusus konfigurasi: "Slot custom memerlukan uri (enum endpoint keluarga tersebut tidak memiliki default)." Endpoint yang menggunakan wire Anthropic Messages ditempatkan pada slot anthropic dengan uri ditetapkan ke override — bukan pada custom. Kunavo menyediakan kedua bentuk wire di bawah https://api.kunavo.com/v1 dengan satu kunci, sehingga secara teori kedua slot cocok. Cuplikan di bawah menggabungkan field slot custom yang didokumentasikan dengan bentuk empat header dari contoh kerja milik dokumentasi; ini adalah adaptasi, bukan blok resmi yang disalin.

# 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

Empat catatan praktis. Kredensial dapat diberikan melalui empat cara — inline api_key, referensi op://vault/item/field 1Password, penyimpanan terenkripsi di ~/.zeroclaw/secrets, atau override env generik ZEROCLAW_providers__models__custom__kunavo__api_key, dengan double underscore dipetakan ke titik. Nama shell default ekosistem seperti $ANTHROPIC_API_KEY bukan dibaca langsung kecuali keluarga penyedia mendokumentasikan bridge env native miliknya sendiri — dokumentasi menyuruh Anda mengembangkannya sendiri menjadi nama schema-mirror — dan variabel env schema-mirror adalah injeksi runtime yang tidak pernah menjadi konfigurasi durable. Slot custom secara default menggunakan wire chat-completions, dan wire_api dihormati pada keluarga bring-your-own-endpoint (openai, llamacpp, custom) sementara slot vendor bermerek memiliki wire tetap dan mengabaikannya, dengan opencode disebut sebagai satu-satunya pengecualian. Jika gateway Anda menolak field temperature, biarkan tidak diatur: dokumentasi menyatakan bahwa temperature yang tidak diatur sepenuhnya dihilangkan dari body permintaan. Dan startup yang bersih membuktikan lebih sedikit daripada yang terlihat — pemanasan koneksi adalah GET yang mengonsumsi body dan menerima status non-sukses, sehingga daemon tetap dimulai; halaman custom-provider di master mendokumentasikannya sebagai GET {base_url}/models, sedangkan kode v0.8.5 memanaskan URL chat-completions.

Lakukan validasi dalam urutan yang didokumentasikan, ketiganya pada v0.8.5: zeroclaw config list memuat konfigurasi dan mencetak kegagalan validasi ke stderr, zeroclaw models refresh --model-provider custom.kunavo mencantumkan apa yang diiklankan endpoint, dan zeroclaw agent -a assistant -m "hello" melakukan smoke test terhadap agen. /v1/models milik Kunavo sendiri menjawab HTTP 401 tanpa kunci (diverifikasi pada 21 September 2026), yang bukan penghalang: perintah refresh mengirimkan kunci alias. Kunavo belum menguji ZeroClaw saat runtime — segala sesuatu dalam bagian ini adalah tinjauan terhadap dokumen sumber ZeroClaw, jadi jalankan satu tugas terbatas Anda sendiri sebelum mempercayai rute tersebut.

Kunavo tidak menyediakan model embedding, text-to-speech, atau speech-to-text, sehingga agen yang memerlukan langkah-langkah tersebut harus mengarahkannya ke endpoint lain, terlepas dari slot ZeroClaw tempat model chat berada.

Meter biaya membaca $0 sampai Anda menulis lembar tarif

ZeroClaw mengukur pengeluarannya sendiri, dan pada gateway pihak ketiga meter tersebut mulai dengan nilai yang salah. Pelacakan biaya dikendalikan oleh cost.enabled, dan catatan ditulis ke ledger append-only di <workspace>/state/costs.jsonl, satu objek JSON per baris. Masalahnya adalah asal harga tersebut. Dalam catalog.rs pada v0.8.5, catalog_source_for tidak mengembalikan kunci models.dev maupun awalan vendor OpenRouter untuk keluarga custom — sebagian besar slot bermerek membawa setidaknya salah satunya, meskipun beberapa (zerorouter, telnyx, nearai) tidak membawa keduanya. Opt-in live_pricing dinonaktifkan secara default, dan jika diaktifkan, pertama-tama membaca listing /models milik endpoint lalu kembali ke models.dev dengan kunci berupa nama models.dev keluarga tersebut; keluarga custom tidak memiliki kunci seperti itu, sehingga pada slot ini listing milik endpoint adalah satu-satunya sumber. Listing Kunavo tidak memuat field harga per token, yang dibaca dari sumber rute, bukan dari respons produksi terautentikasi. Jadi alias slot custom mencatat cost_usd = 0 dengan unpriced_tokens di atas nol sampai Anda memasukkan tarif sendiri.

[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

Tiga perilaku mengikuti hal tersebut, semuanya berasal dari dokumentasi pelacakan biaya, diperiksa pada 21 September 2026. Entri tarif menggunakan ID model upstream sebagai kunci, sebagaimana muncul dalam telemetri penggunaan, bukan alias Anda. Perbandingan anggaran menggunakan cost_usd, sehingga total harian atau bulanan yang berada di bawah batas bukan jaminan keamanan selama bulan tersebut memuat token yang belum diberi harga. Dan baris ledger yang sudah ada tidak pernah dihitung ulang harganya: "tidak ada penghitungan ulang harga secara retroaktif", sehingga tarif hanya berlaku untuk permintaan yang dibuat setelah Anda mengonfigurasinya. Penegakan memiliki tiga mode — warn (default), block, dan route_down, yang menggantikan dengan route_down_model yang lebih murah — ditambah allow_override, yang secara default bernilai false dan memungkinkan permintaan melewati block dengan token override pada CLI.

Perkiraan yang dikerjakan berdasarkan batas harian ZeroClaw sendiri

Ini adalah aritmetika token ilustratif, bukan biaya tugas yang diukur dan bukan batas maksimum tagihan. Contoh kerja [runtime_profiles] dalam dokumentasi membatasi agen pada max_actions_per_hour = 10 dan max_cost_per_day_cents = 100 — nilai contoh untuk model lokal kecil, bukan default. Anggap batas tersebut secara harfiah untuk delapan jam aktif per hari: 80 giliran per hari, masing-masing mengirim 6.000 token input tanpa cache dan mengembalikan 500 token output. Tarifnya adalah harga live katalog Kunavo per juta token.

Pembacaan yang berguna bukanlah peringkatnya, melainkan interaksinya dengan batas. Profil yang ditulis untuk model lokal kecil menempatkan model frontier di bawah batas yang sama: max_actions_per_hour membatasi volume giliran, dan batas biaya harian menolak permintaan hanya ketika enforcement.mode adalah block. Di bawah warn, yaitu default, batas tersebut sama sekali tidak memblokir — sistem mencatat peristiwa dan membiarkan permintaan diteruskan. (warn_at_percent, default 80%, adalah pengaturan terpisah: ini mengontrol kapan gateway menampilkan peringatan sebelum batas keras.) Lebih buruk lagi, jika Anda tidak pernah menulis lembar tarif di atas, semua ini tidak berjalan, karena batas tidak dapat melihat token yang belum diberi harga. Skala tabel berdasarkan volume giliran dan rasio input-output Anda sendiri sebelum menganggapnya sebagai anggaran; tabel ini tidak mencakup biaya cache, tool call, dan percobaan ulang, serta mengasumsikan model yang lebih murah menyelesaikan pekerjaan tanpa percobaan tambahan.

Jumlah katalog Kunavo adalah batas minimum penagihan, bukan batas maksimum: ketika upstream melaporkan biayanya, tagihan adalah nilai yang lebih besar antara biaya katalog dan biaya upstream yang dikalikan markup yang berlaku. Top-up minimum adalah $10 dalam kredit prabayar, yang merupakan minimum pendanaan, bukan biaya tugas atau langganan — lihat detail penagihan.

Model terbaik dan API terbaik untuk ZeroClaw: apa yang akan dan tidak akan diberitahukan proyek ini kepada Anda

ZeroClaw tidak menerbitkan model yang direkomendasikan, dan menolak melakukannya secara resmi. Halaman penyiapan multi-model menyatakan bahwa "alur kerja ini tidak menetapkan daftar model yang diverifikasi ZeroClaw" dan bahwa "bukti untuk satu build, model, kuantisasi, dan pengaturan konteks tidak memverifikasi kombinasi lainnya". Itulah jawaban jujur untuk "model terbaik bagi ZeroClaw": tidak ada peringkat resmi yang dapat dikutip, jadi pilih berdasarkan dua properti yang dapat diuji.

Yang pertama adalah pemanggilan tool native, dan halaman yang sama menetapkan standar ketat untuknya: "Periksa proses untuk menemukan tool call aktual, hasil eksekusinya, dan kelanjutan dari asisten yang menggunakan hasil tersebut. Jawaban yang masuk akal atau markup tool-call yang hanya dicetak bukan uji tool yang lulus." Pengaturan profil runtime strict_tool_parsing memperlakukan teks fallback yang tampak seperti XML atau JSON sebagai teks asisten biasa, kecuali penyedia mengembalikan tool call nyata, sehingga model yang sekadar mendeskripsikan tool call akan tampak berfungsi tetapi tidak pernah bertindak. Yang kedua adalah apakah model menyelesaikan tugas Anda tanpa percobaan tambahan — itulah sebabnya harga tercantum termurah dan biaya terendah untuk menyelesaikan tugas adalah klaim yang berbeda.

Ada dua perilaku yang perlu dianggarkan sebelum Anda mengaktifkan failover. Streaming memiliki kontrak yang lebih terbatas: halaman siklus hidup perutean penyedia menyatakan bahwa wrapper "memilih entri berurutan pertama yang mendukung kapabilitas stream yang diminta dan tidak sedang dalam masa cooldown", lalu "membuka stream tersebut sekali" dan "tidak mengganti entri setelah stream dimulai" — meskipun stream yang gagal sebelum output apa pun dikomit akan dicoba ulang melalui jalur non-streaming, yang kembali menjalankan seluruh proses keandalan pada fallback_models dan fallback. Percobaan ulang non-streaming tersebut mencakup timeout, kesalahan koneksi, 429, dan 503, serta secara eksplisit tidak mencakup 400, kegagalan autentikasi permanen, atau kesalahan output model. Entri fallback juga dapat memindahkan pekerjaan ke tingkat harga yang berbeda, jadi tetapkan anggaran untuknya terlebih dahulu. Untuk perbandingan rute gateway yang lebih luas, lihat panduan API yang kompatibel dengan OpenAI dan alternatif OpenRouter.

Pekerjaan rutin: profil risiko, batas, dan layanan yang memulai ulangnya

Otonomi berlaku per agen, bukan secara global. Halaman otonomi pada v0.8.5 menerima tepat tiga level — readonly, supervised, dan full — serta menolak read_only dengan garis bawah saat pemuatan konfigurasi. Di bawah supervised default, alat berisiko rendah berjalan otomatis, alat berisiko sedang memunculkan permintaan persetujuan operator, dan alat berisiko tinggi diblokir. Permintaan persetujuan kedaluwarsa setelah approval_timeout_secs milik kanal tersebut, yaitu 120 detik untuk sebagian besar kanal, dan timeout dihitung sebagai penolakan — karena itu, agen yang tidak diawasi gagal secara tertutup, bukan mengantre.

Ada dua batasan pada pekerjaan rutin. Perilaku mulai ulang tidak seragam di semua platform: unit pengguna systemd yang terpasang menetapkan Restart=always dengan RestartSec=3 dan tanpa daftar kode keluar yang diizinkan, sehingga daemon yang gagal cepat karena konfigurasi yang buruk akan terus berulang; LaunchAgent macOS menetapkan RunAtLoad dan KeepAlive; sedangkan di Windows, zeroclaw service install mendaftarkan tugas Task Scheduler ONLOGON yang memulai daemon saat logon tanpa menambahkan kebijakan mulai ulang saat gagal. Pekerjaan terjadwal sendiri bersifat deklaratif dan menggunakan alias pada [cron.<alias>], terpisah dari pengaturan milik bagian [scheduler]. Selain itu, mesin SOP deterministik ditandai sebagai eksperimental oleh matriks fitur proyek sendiri — pemicu periferal dan kalender telah didefinisikan dan dicocokkan, tetapi belum dirutekan ke sumber langsung — jadi jangan merancang alur kerja tanpa pengawasan berdasarkan fitur tersebut untuk saat ini.

Siapkan dan periksa tagihan pertama

Kunavo tidak menerbitkan halaman integrasi khusus ZeroClaw dan belum menguji klien ini saat runtime, jadi perlakukan konfigurasi di atas sebagai rute berdasarkan dokumen sumber, bukan hasil kompatibilitas. Urutan praktisnya singkat: buat kunci, isi saldo minimum, tulis empat header, jalankan tiga perintah validasi secara berurutan, lalu tulis blok [cost.rates.*] sebelum proses panjang pertama agar ledger memiliki sesuatu untuk dicatat. Mulailah dari quickstart untuk base URL dan format kunci, referensi chat-completions untuk protokol wire yang digunakan slot custom, dan buat akun Kunavo saat Anda siap mengisi saldo. Jika agen Anda menggunakan protokol Anthropic, dokumen base URL Anthropic membahas rute slot anthropic.

Pertanyaan umum

Diperiksa pada 21 September 2026. Dibaca ulang secara langsung untuk halaman ini: FAQ zeroclaw.com, README repositori, API GitHub untuk status repositori dan rilis v0.8.5, migration.rs, schema/v1.rs, catalog.rs, compatible.rs, providers/custom.md, security/autonomy.md, dan ops/service.md pada tag v0.8.5, serta pada master, lensa migrasi V2, 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, dan reference/feature-matrix.md, ditambah repositori zerorouter, situs pihak ketiga dan landing page yang disebutkan di atas, serta GET tanpa autentikasi ke /v1/models milik Kunavo. Apa pun yang dikutip dari master adalah dokumentasi cabang pengembangan dan dapat mendahului rilis stabil. Kunavo belum menguji ZeroClaw saat runtime: tidak ada instalasi, config list, maupun proses agen yang dilakukan, sehingga streaming, pemanggilan alat native, dan visi melalui rute ini belum terverifikasi di sini. Tarif token Kunavo dibaca dari katalog langsung, dan setiap angka dolar di halaman ini adalah perhitungan token ilustratif.