Backend CLI OpenClaw

Saat penyedia API sedang down, terkena batas laju, atau berperilaku tidak semestinya, OpenClaw dapat menjalankan CLI AI lokal sebagai cadangan khusus teks. Dokumentasi sengaja menetapkan bentuknya: alat tidak disuntikkan secara langsung, meskipun backend dapat menerima alat Gateway melalui jembatan MCP loopback, streaming menggunakan JSONL jika CLI mendukungnya, sesi didukung sehingga pesan lanjutan tetap koheren, dan gambar diteruskan jika CLI menerima jalur file. Ini adalah jaring pengaman, bukan jalur utama, dan bukan ACP. Berikut mulai cepat, penyambungan cadangan, mekanisme sebuah giliran, detail spesifik Claude CLI, sesi, jembatan MCP, compaction, dan batasannya.

Mulai cepat dan cadangan

• Plugin Anthropic bawaan mendaftarkan backend Claude CLI yang berfungsi tanpa konfigurasi apa pun selain Claude Code yang sudah terinstal dan login; eksekusi agen satu pesan dengan referensi model Claude CLI membuktikannya, dan layanan Gateway harus memiliki CLI tersebut di path-nya, dengan plugin backend untuk executable yang tidak standar.
• Untuk menggunakannya hanya saat model utama gagal, tambahkan model Claude CLI ke daftar cadangan; cadangan yang dikonfigurasi tetap memenuhi syarat saat model utama gagal karena autentikasi, batas laju, atau batas waktu, bahkan jika tidak ada dalam kebijakan izin model, yang hanya berpengaruh untuk pemilihan langsung.
• Untuk merutekan model Anthropic kanonis melalui CLI, setel id runtime agen pada model tersebut; kredensial tetap berada di profil autentikasi atau konfigurasi plugin, dan perintah, argumen, lingkungan, parsing, sesi, gambar, serta mekanisme watchdog adalah kode plugin.
• Sebuah giliran memilih backend berdasarkan prefiks penyedia, membangun prompt sistem dari prompt OpenClaw dan konteks ruang kerja yang sama, mengeksekusi CLI dengan id sesi jika didukung, mem-parse JSON atau teks, dan menyimpan id sesi per backend sehingga pesan lanjutan menggunakan ulang sesi tersebut.

Gunakan sebagai jaring pengaman untuk respons teks yang “selalu berhasil”, bukan sebagai jalur utama.

Detail spesifik Claude CLI

Backend bawaan berkomunikasi dengan executable Claude Code yang terinstal melalui protokol stdio terstrukturnya, mempertahankan satu subprocess hangat di seluruh giliran yang kompatibel, memulai yang baru saat model, prompt sistem, atau kebijakan alat berubah, dan melanjutkan dari id sesi yang tersimpan setelah restart; Claude Code memiliki login dan langganannya sendiri, dan OpenClaw tidak pernah membaca, menyimpan, menyegarkan, atau meneruskan token native. Konteks hook pembuatan prompt sampai ke Claude sebagai lampiran hook native, catatan sesi yang tersimpan diputar ulang dalam anggaran berbobot yang terbatas, resolver skill native digunakan melalui direktori plugin sementara saat skill memiliki jalur yang termaterialisasi, dan instruksi Git milik Claude Code dinonaktifkan agar editan ruang kerja tidak membatalkan riwayat cache-nya. Claude Code diluncurkan dalam mode izin default-nya, sementara respons izin OpenClaw dan hook pra-alat menjaga alat native tetap di bawah kendali host, dengan memproyeksikan nama alat native dan argumen file ke padanannya di OpenClaw sebelum kebijakan exec dan persetujuan; saat pengaturan exec ask meminta konfirmasi, permintaan alat native diteruskan ke saluran sesi dengan pilihan allow once, allow always untuk sesi hangat yang sama, dan deny, di mana batas waktu yang habis, rute yang tidak terjangkau, atau giliran yang sudah ditutup semuanya berarti deny, dan allow always tidak pernah berlaku untuk Bash. Level thinking dipetakan ke flag effort milik Claude Code dan, untuk model dengan anggaran tetap, ke nilai max-thinking-tokens, dan login native maupun token langganan yang ditempel sama-sama berfungsi.

Bash native, sesi, jembatan

• Dengan pengaturan ask on-miss, perintah Bash native diperiksa terhadap daftar izin exec agen menggunakan evaluator shell milik OpenClaw sendiri: sebuah panggilan berjalan tanpa konfirmasi hanya jika setiap segmen di-resolve ke binary yang ada di daftar izin dan dapat diikat sepenuhnya, pipeline, substitusi, subshell, dan pengalihan ditolak sebelum konfirmasi apa pun, dan ini adalah kebijakan tingkat argumen pada perintah yang akan dijalankan Claude Code, bukan eksekusi dalam sandbox, karena Claude Code-lah yang memiliki direktori kerja, path, lingkungan, dan sandboxing.
• Sesi CLI yang tersimpan adalah kontinuitas milik penyedia yang diverifikasi terhadap transkrip yang dapat dibaca sebelum dilanjutkan; sesi baru dapat memulihkan riwayat OpenClaw dari database sesi saat batas akun cocok dengan kredensial yang dipilih, dan sidik jari akun privat dengan cakupan transkrip yang berkesinambungan menentukan kelayakannya, jadi berganti akun membuat riwayat campuran tidak memenuhi syarat dan identitas autentikasi yang berubah menghentikan penggunaan ulang sesi. Percobaan Claude CLI yang gagal dapat beralih ke model non-CLI yang diberi pembuka hasil ambilan dari transkrip lokal Claude Code, yaitu ringkasan compaction terbarunya ditambah giliran-giliran terkini.
• Backend yang memilih ikut overlay bundle-MCP mendapatkan server MCP HTTP loopback yang mengekspos alat Gateway ke proses CLI dengan token per eksekusi, terikat pada sesi, akun, dan saluran yang dipilih Gateway; kebijakan allow dan deny juga membatasi server MCP native, eksekusi terbatas seperti job cron menonaktifkan alat native dan kustomisasi Claude sepenuhnya dan hanya mengekspos alat OpenClaw yang diizinkan, dan runtime jembatan dengan cakupan sesi dibersihkan setelah sepuluh menit menganggur.

OpenClaw dan Claude Code adalah pasangan yang sama dilihat dari sisi lain, dan failover model OpenClaw adalah mekanisme yang menentukan kapan cadangan berjalan.

Batas waktu, compaction, batasan

Ada dua batas yang independen: anggaran giliran agen, 48 jam secara default dan nol untuk tanpa batas, serta watchdog tanpa-output CLI yang dimiliki backend, yang tetap aktif bahkan saat anggaran giliran tidak dibatasi; pekerjaan latar belakang yang dimulai di dalam CLI mati bersama subprocess saat giliran berakhir, jadi pekerjaan panjang yang harus bertahan sebaiknya diserahkan ke sub-agen yang terlepas. Backend Claude CLI menyatakan bahwa ia memiliki compaction native, jadi OpenClaw menyerahkannya ke Claude Code dan meneruskan anggaran konteks melalui jendela auto-compact Claude Code, sementara perintah compact eksplisit melanjutkan sesi yang terikat dan mengirim perintah native-nya; backend Gemini CLI juga memiliki compaction-nya sendiri, tanpa perintah manual. Anthropic memiliki backend Claude dan Google memiliki backend Gemini, yang prasyaratnya adalah CLI di path dan profil kunci Google AI Studio; tidak ada backend Codex CLI bawaan, karena Codex berjalan melalui harness app-server. Batasannya: tidak ada panggilan alat yang disuntikkan ke protokol CLI tanpa jembatan, streaming yang bervariasi menurut backend, dan output terstruktur yang bergantung pada JSON milik CLI itu sendiri. Persetujuan exec OpenClaw membahas daftar izin yang menjadi acuan pemeriksaan Bash native, dan OpenClaw dan Gemini membahas penyedia di balik backend bawaan kedua.

Di Diali

Di Diali tidak ada CLI host untuk dijadikan cadangan: rute model adalah kunci API di Vault atau kredit terkelola, dan failover terjadi antarpenyedia, bukan ke binary lokal. OpenClaw yang di-hosting di Diali adalah asistennya dan model dan penyedia OpenClaw membahas penyedia yang dapat digunakan rute itu.

• Cadangan, bukan jalur utama.
• Subprocess yang tetap hangat, login native, alat hanya melalui jembatan.
• Oleh OpenClaw, Bash native dibatasi dengan daftar izin, tidak pernah di-sandbox.