Beberapa agen dan model OpenClaw: perutean, isolasi, dan biaya

Multi-agen OpenClaw dan beberapa model adalah dua lapisan berbeda dalam satu file konfigurasi: beberapa agen berupa entri berkunci di bawah agents.entries, masing-masing memiliki workspace, direktori status, dan penyimpanan sesi sendiri, sementara beberapa model berupa nilai model per agen di dalam entri tersebut. Dua lapisan lain berada di sampingnya — bindings menentukan agen mana yang menjawab, dan rantai fallback menentukan tindakan satu agen ketika modelnya gagal. Mengedit lapisan yang salah adalah alasan paling umum perubahan tampak tidak menghasilkan apa-apa.

Menjalankan lebih banyak agen tidak memerlukan biaya dalam perangkat lunak. Ikhtisar dokumentasi OpenClaw menyatakan bahwa OpenClaw dikembangkan secara terbuka oleh "OpenClaw Foundation, sebuah organisasi independen 501(c)(3)" dengan "Tidak ada tingkat berbayar, tidak ada telemetri secara default selain pemeriksaan versi yang dapat Anda nonaktifkan, tidak ada lab yang memilikinya", dan openclaw.ai menambahkan "Tidak ada langganan. Tidak ada tingkat ter-host. Tidak ada token." Paket npm openclaw berlisensi MIT, dengan latest pada 2026.9.5 di samping channel extended-stable pada 2026.7.35 dan engines.node dari >=24.16.0 <25 || >=26.1.0 (registri npm, diperiksa pada 21 September 2026). Yang ditambahkan agen kedua ke tagihan Anda adalah token.

Multi-agen OpenClaw: empat lapisan dan gejala ketika Anda mengedit lapisan yang salah

Keempatnya dibaca dari dokumentasi OpenClaw sendiri pada 21 September 2026: entri dan multi-agen, binding agen, dan failover model. Dua bentuk dalam tutorial lama sudah usang: roster array agents.list adalah bentuk lama yang dimigrasikan oleh Doctor, dan penanda default: true pada entri sudah dihentikan — halaman entri dengan jelas menyatakan bahwa "default sudah dihentikan" dan bahwa operasi multi-agen memerlukan binding atau target eksplisit. OpenClaw juga pernah menggunakan dua nama sebelumnya, jadi konfigurasi era Moltbot atau Clawdbot apa pun yang Anda temukan mendahului skema ini.

Penyiapan beberapa agen OpenClaw: konfigurasi minimal dua agen, dua model

Fragmen ini mengasumsikan Anda sudah memiliki blok models.providers yang berfungsi — API terbaik untuk OpenClaw memuat konfigurasi Kunavo, termasuk api: "anthropic-messages" dan base URL yang dipublikasikan di Anthropic base URL. Bagian selanjutnya hanya membahas lapisan agen dan routing.

{
  "agents": {
    "defaults": {
      "modelSelectionScope": "session",
      "model": {
        "primary": "kunavo/claude-haiku-4-5",
        "fallbacks": [
          "kunavo/claude-sonnet-5"
        ]
      }
    },
    "entries": {
      "ops": {
        "name": "Ops",
        "workspace": "~/.openclaw/workspace-ops",
        "agentDir": "~/.openclaw/agents/ops/agent",
        "model": "kunavo/claude-haiku-4-5",
        "modelPolicy": {
          "allow": [
            "kunavo/claude-haiku-4-5"
          ]
        }
      },
      "build": {
        "name": "Build",
        "workspace": "~/.openclaw/workspace-build",
        "agentDir": "~/.openclaw/agents/build/agent",
        "model": {
          "primary": "kunavo/claude-opus-5",
          "fallbacks": [
            "kunavo/claude-sonnet-5"
          ]
        },
        "utilityModel": "kunavo/claude-haiku-4-5"
      }
    }
  },
  "bindings": [
    {
      "agentId": "build",
      "match": {
        "channel": "discord",
        "accountId": "build"
      }
    },
    {
      "agentId": "ops",
      "match": {
        "channel": "discord",
        "accountId": "*"
      }
    }
  ]
}

Empat hal dalam blok tersebut menjadi penentu. Setiap agen memiliki agentDir sendiri, karena halaman multi-agen memperingatkan: "Jangan pernah menggunakan ulang agentDir di antara agen — hal itu menyebabkan benturan status autentikasi/sesi." Agen ops menggunakan bentuk string dari model, yang didefinisikan halaman entri sebagai "primary per agen yang ketat tanpa fallback model" — sehingga kegagalan muncul alih-alih diam-diam memindahkan pekerjaan rutin ke tingkat yang lebih mahal. Agen build menggunakan bentuk objek dengan daftar fallbacks eksplisit, yang merupakan cara untuk mengikutsertakan agen; halaman failover menambahkan bahwa agen dapat menetapkan model: { fallbacks: [...] } saja dan tetap mewarisi primary bersama. Binding yang sempit berada di atas wildcard, karena dalam satu tingkat pencocokan "entri bindings pertama yang cocok akan menang."

Default workspace berbeda antara agen default dan agen lainnya, dan layak ditetapkan secara eksplisit: workspace agen default adalah <stateDir>/workspace, sedangkan workspace agen lain secara default adalah <stateDir>/workspace-<agentId>. Memori mengikuti workspace, karena engine bawaan OpenClaw "mengingat berbagai hal dengan menulis file Markdown biasa di workspace agen Anda" — jadi mengisolasi workspace berarti mengisolasi memori. Mode izin sesi adalah sumbu yang terpisah lagi: read-only, guarded, workspace, dan full, dengan ketentuan bahwa "full memerlukan operator.admin. Mode lainnya memerlukan operator.write" (mode izin, 21 September 2026). Model murah pada agen permisif tetap merupakan agen permisif.

Apa yang dipisahkan oleh agen terpisah — dan apa yang tidak

Inilah batas yang tidak terlihat dalam tabel harga. Entri terpisah memberi Anda file, memori, riwayat, kebijakan alat, dan profil autentikasi tersimpan yang terpisah. Namun, entri tersebut tidak dengan sendirinya memberi setiap agen API key sendiri untuk penyedia kustom yang dikonfigurasi melalui lingkungan — skema per agen yang didokumentasikan sama sekali tidak memiliki kolom baseUrl, apiKey, atau providers. Ketiadaan dari dokumentasi bukan bukti bahwa kode melarangnya, jadi baca ini sebagai tidak terdokumentasi; jika Anda memerlukan pemisahan kunci yang tegas per tenant, jalankan Gateway terpisah. Batas terkait berlaku untuk identitas: contoh pemisahan DM WhatsApp OpenClaw mencatat bahwa "Balasan tetap berasal dari nomor WhatsApp yang sama — tidak ada identitas pengirim per agen", dan bahwa "Chat langsung secara default digabungkan ke kunci sesi utama agen, sehingga isolasi sejati memerlukan satu agen per orang." Pernyataan itu berlaku untuk WhatsApp; periksa halaman channel Anda sendiri sebelum menggeneralisasikannya.

Satu batas kemampuan yang perlu diperhatikan saat Anda membagi peran: Kunavo tidak menyediakan model text-to-speech, speech-to-text, atau embedding, jadi agen yang memerlukan output suara atau indeks vektor harus memanggil penyedia eksternal untuk langkah tersebut.

Beberapa model OpenClaw: strict, fallback, kebijakan, dan jalur utilitas

Pemilihan model per agen memiliki empat kontrol yang layak ditetapkan secara sengaja. model sebagai string bersifat strict. { primary, fallbacks: [...] } mengikutsertakan agen tersebut dalam failover. modelPolicy.allow adalah allowlist yang "menggantikan kebijakan default untuk agen tersebut" — menerima alias, referensi persis, dan wildcard di akhir — yang merupakan cara untuk mencegah agen rutin mencapai model mahal. Dan utilityModel adalah model terpisah yang biasanya lebih murah untuk "tugas internal singkat seperti judul sesi dan thread yang dibuat secara otomatis", dengan override per agen.

Daftar pemicu yang didokumentasikan bersifat spesifik. OpenClaw beralih pada "kegagalan autentikasi, batas laju dan habisnya cooldown, kesalahan overloaded/provider-busy, kesalahan failover berbentuk timeout, penonaktifan penagihan, model_not_found", serta pada kesalahan lain yang tidak dikenali selama masih ada kandidat — tetapi tidak pada kesalahan context overflow, yang tetap berada dalam logika pemadatan dan percobaan ulang, dan tidak pada "pembatalan eksplisit yang tidak berbentuk timeout/failover". Di luar percakapan grup dan channel, hal ini terlihat: permukaan tersebut memposting pemberitahuan status berbentuk Model Fallback: <fallback> (selected <primary>; <reason>) dan pemberitahuan penghapusan yang sesuai, sedangkan percakapan grup dan channel "menyembunyikan pemberitahuan yang terlihat sambil mempertahankan status fallback yang sama", jadi jangan mengandalkan kemunculannya di ruang bersama. Pemilihan sesi eksplisit — /model, pemilih model, session_status(model=...), atau sessions.patch — bersifat strict: jika model tersebut gagal sebelum menghasilkan balasan, OpenClaw melaporkan kegagalan alih-alih menjawab dari fallback yang dikonfigurasi. --model pada tugas cron bukan salah satunya; dokumentasi menyebutnya sebagai primary tugas yang tetap menggunakan fallback terkonfigurasi kecuali tugas tersebut menetapkan payload.fallbacks: [].

Dua mekanisme lain menentukan apakah maksud Anda tetap berlaku. Parameter permintaan digabungkan melalui empat lapisan, dari agents.defaults.params hingga agents.entries.*.params, dengan lapisan yang lebih akhir menimpa berdasarkan kunci. Paralelisme juga memiliki batas terhitung: agents.defaults.maxConcurrent secara default bernilai max(8, available CPU parallelism * 4) di seluruh sesi, sementara setiap sesi tetap serial — dua pesan kepada satu agen tidak berjalan bersamaan. Untuk memilih model yang sesuai bagi setiap peran, Opus vs Sonnet vs Haiku membahas sisi kemampuan.

Atribusi biaya berdasarkan rute, bukan agen

Karena tidak ada perintah terdokumentasi yang melaporkan pengeluaran per agen, lakukan atribusi berdasarkan rute. Perhitungan di bawah ini bersifat ilustratif, bukan tagihan yang diukur dan bukan batas atas. Perhitungan ini mengasumsikan bulan 30 hari, default heartbeat 30m yang terdokumentasi (1.440 eksekusi), 300 token output per heartbeat, tanpa cache hit, dan jalur percakapan utama dengan 8M token input serta 500K token output. Angka konteks sekitar 100K dan ~2–5K per eksekusi adalah ilustrasi OpenClaw sendiri tentang apa yang dihapus oleh isolatedSession, bukan sesuatu yang diukur di sini; 3.000 adalah titik tengahnya. Tarifnya adalah harga terkini dalam katalog Kunavo per juta token.

Claude Haiku 4.5 mencantumkan $0,70 / $3,50 dan Claude Opus 5 mencantumkan $3,50 / $17,50 per juta token input / output di katalog langsung. Hal yang penting: berdasarkan asumsi ini, jalur terjadwal menjadi faktor dominan. Heartbeat sesi bersama pada model kuat menghasilkan sekitar $511,56 per bulan, dibandingkan $4,54 untuk cadence yang sama dengan isolatedSession: true pada model murah. OpenClaw sendiri menyatakannya — "Heartbeat menjalankan giliran agen penuh. Interval yang lebih pendek menghabiskan lebih banyak token" — dan menyebut isolatedSession, lightContext, model yang lebih murah, serta target: "none" sebagai tuas pengaturan.

Trik heartbeat murah memiliki mode kegagalan yang terdokumentasi, dan itulah alasan isolatedSession menjadi tuas yang lebih baik daripada hanya mengganti model. Heartbeat “mempertahankan model runtime yang sudah ada pada sesi bersama setelah proses selesai”, sehingga heartbeat yang mengalihkan sesi ke model yang lebih kecil dapat membuatnya tetap digunakan pada giliran sesi utama berikutnya, yang kemudian mungkin melaporkan context overflow — pesan pemulihan OpenClaw menyebutnya heartbeat model bleed. Contoh dalam dokumentasi menggunakan model lokal dengan jendela 32k, jadi besarnya risiko bergantung pada seberapa jauh lebih kecil jendela konteks model heartbeat dibandingkan kebutuhan sesi bersama. Satu catatan penjadwalan: interval default yang terdokumentasi adalah 30m, dan dinaikkan menjadi 1h hanya ketika mode autentikasi yang ditetapkan adalah Anthropic OAuth/token, sehingga rute dengan kunci API biasa tetap menggunakan 30m kecuali Anda menetapkan heartbeat.every sendiri. Periksa nilai Anda sendiri sebelum menyusun anggaran.

Dua catatan tentang angka dolar. Nominal katalog Kunavo merupakan 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. Dan provider khusus yang dideklarasikan tanpa objek cost per model membuat pembacaan OpenClaw sendiri tidak berguna — default-nya adalah cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }, sehingga menampilkan $0 sementara pemasok tetap menagih seperti biasa. Deklarasikan cost, contextWindow dan maxTokens pada setiap model yang Anda tambahkan, lalu rekonsiliasikan dengan buku besar provider. Top-up minimum Kunavo adalah $10 dalam kredit prabayar — minimum pendanaan, bukan biaya tugas atau langganan. Lihat detail penagihan dan optimalisasi biaya AI.

Rute pembelian mana yang cocok untuk Gateway multi-agen

Satu catatan tentang dialek, karena caching adalah tempat uangnya. Blok Kunavo dalam panduan terkait mendeklarasikan api: "anthropic-messages", yang diperlakukan OpenClaw sebagai endpoint Anthropic non-langsung. Ada dua konsekuensi yang terdokumentasi. Header beta Anthropic implisit ditekan pada endpoint tersebut, sehingga fitur seperti pemikiran terinterkalasi harus diaktifkan melalui headers["anthropic-beta"] eksplisit, bukan otomatis. Dan caching harus diminta: OpenClaw hanya menginisialisasi cacheRetention: "short" untuk provider langsung anthropic dan anthropic-vertex, sedangkan “endpoint yang kompatibel dengan anthropic-messages khusus” didukung “ketika cacheRetention ditetapkan secara eksplisit” — jadi tetapkan params.cacheRetention sendiri, bukan menganggapnya sebagai default (caching prompt, 21 September 2026). Aturan terpisah berlaku untuk dialek lainnya: rute openai-completions ke endpoint non-native mengirimkan “tidak ada petunjuk prompt-cache”. Verifikasi penggunaan cache yang dilaporkan pada rute Anda sendiri sebelum menganggarkan konteks berulang sebagai cache hit. Caching prompt membahas sisi tarifnya.

Pastikan konfigurasi diterapkan di tempat yang dimaksud

openclaw config validate
openclaw gateway restart
openclaw agents list --bindings
openclaw models status --agent ops --json --check
openclaw models list --agent build

Validasi konfigurasi memeriksa struktur, dan restart gateway memuat ulang konfigurasi; keduanya tidak membuktikan bahwa permintaan berbayar berhasil. openclaw agents list --bindings menunjukkan routing yang benar-benar dimuat — utamakan ini daripada --tree, yang muncul di halaman konsep tetapi tidak dalam tabel perintah CLI. openclaw models status --agent <id> menjelaskan default terkonfigurasi agen tersebut, dan models list --agent <id> menampilkan inventarisnya. Jika models set keluar dengan status nonzero untuk provider yang tidak dikenal, itu adalah lapisan model: provider harus berupa plugin yang terpasang atau dideklarasikan di bawah models.providers. Jika pesan tidak mencapai agen mana pun, itu adalah lapisan routing. Jika eksekusi duplikat muncul setelah beberapa agen berbagi saluran, OpenClaw mendokumentasikan kunci perlindungan loop bot sebagai pengaman — dokumentasi menjelaskan pencegahan, bukan akar masalah, jadi lakukan diagnosis sebelum berasumsi.

Kemudian jalankan satu tugas terbatas per agen dan baca biaya yang dicatat oleh akun provider Anda untuk tugas tersebut. Kunavo belum menguji OpenClaw saat runtime, baik dalam konfigurasi satu agen maupun multi-agen: semua uraian di atas dibaca dari dokumentasi OpenClaw yang dipublikasikan, dan konfigurasi yang dipublikasikan bukanlah uji kompatibilitas. Pertahankan rute yang berfungsi saat mencobanya. Mulailah dari konfigurasi provider, bandingkan total biaya operasional di harga OpenClaw, dan buat akun Kunavo saat Anda siap mendanai sebuah kunci.

Pertanyaan umum

Dokumentasi OpenClaw, referensi CLI, dan entri registri npm diperiksa pada 21 September 2026 untuk versi paket 2026.9.5; tidak ada Gateway, agen, binding, atau permintaan berbayar yang dijalankan di sini. Tarif token Kunavo dibaca dari katalog langsung, dan setiap angka dolar di halaman ini merupakan perhitungan token ilustratif, bukan tagihan terukur.