Agen ACP OpenClaw

Anda ingin mengendalikan Claude Code atau Gemini CLI dari pesan Telegram, bukan dari terminal, dan OpenClaw dapat melakukannya melalui Agent Client Protocol. Sesi ACP menjalankan harness eksternal yang sebenarnya sebagai proses di host Gateway, melacak setiap spawn sebagai tugas latar belakang, dan dapat mengikat percakapan atau utas agar pesan lanjutan terus sampai ke harness yang sama. Sesi ini memerlukan plugin runtime terlebih dahulu, dan sebuah daftar pendek syarat menentukan apakah agen Anda pernah diberi tahu bahwa jalur itu ada.

Menginstal plugin runtime acpx

• Instalasi terpaket menggunakan plugin runtime acpx resmi, yang dipublikasikan di bawah scope openclaw di npm, dan caranya cukup dua perintah: openclaw plugins install, dengan menyebut paket ber-scope tersebut, lalu openclaw config set plugins.entries.acpx.enabled true. Checkout dari source dapat memakai plugin workspace lokal extensions/acpx setelah pnpm install sebagai gantinya. Jalankan /acp doctor sesudahnya untuk pemeriksaan kesiapan, atau /acp install agar OpenClaw mencetak langkah instalasi dan pengaktifan yang deterministik.
• Jika plugins.allow disetel, nilainya adalah inventaris plugin yang membatasi, bukan sekadar petunjuk, dan harus menyertakan acpx; jika tidak, backend ACP yang sudah terinstal sengaja diblokir. Inilah kegagalan saat pertama dijalankan yang paling sering disalahartikan sebagai instalasi rusak, yang muncul sebagai error yang menyatakan bahwa backend runtime ACP belum dikonfigurasi; /acp doctor melaporkan entri daftar izin yang hilang alih-alih membiarkan Anda menebak-nebak.
• Plugin acpx menyematkan runtime ACP secara langsung, jadi tidak ada biner atau versi acpx terpisah yang perlu dikonfigurasi. Plugin ini mendaftarkan backend tersemat selama startup Gateway dan menunggu satu probe kesehatan sebelum sinyal siap gateway, dan probe itu juga menyediakan diagnostik kegagalan. Batas waktunya diatur oleh plugins.entries.acpx.config.timeoutSeconds, yang default-nya 120 detik agar harness yang lebih lambat seperti Gemini CLI dapat menyelesaikan startup dan inisialisasi ACP.
• Adaptor ACP Codex disertakan bersama plugin acpx dan dijalankan secara lokal bila memungkinkan, dengan CODEX_HOME terisolasi tempat OpenClaw menyalin entri kepercayaan proyek yang tepercaya serta konfigurasi perutean model dan penyedia yang aman, sementara autentikasi, notifikasi, dan hook tetap hanya berada di konfigurasi host. Adaptor harness lain dapat diambil sesuai permintaan dengan npx saat pertama kali digunakan, sehingga host tanpa npm atau akses jaringan akan gagal mengambilnya sampai cache dipanaskan terlebih dahulu atau adaptor diinstal dengan cara lain.

Jika ada syarat yang tidak terpenuhi, skill ACP dan panduan ACP sessions_spawn tetap tersembunyi agar agen tidak menyarankan backend yang tidak tersedia.

Mengapa skill ACP bisa tidak terlihat

Syaratnya dicantumkan lengkap: ACP harus diaktifkan, dispatch tidak boleh dinonaktifkan, sesi saat ini tidak boleh diblokir sandbox, dan backend runtime harus dimuat serta sehat. Agen yang belum pernah sekali pun menawarkan spawn ACP biasanya sedang melaporkan konfigurasinya sendiri dengan akurat, bukan mengabaikan Anda. Kedua bagian itu gagal dengan cara berbeda: acp.dispatch.enabled=false menjeda dispatch utas ACP otomatis tanpa menyembunyikan atau memblokir panggilan sessions_spawn eksplisit dengan runtime acp, sedangkan peminta yang berada di sandbox langsung ditolak karena runtime ACP berjalan di sisi host. Dari sesi yang berada di sandbox, jawaban yang terdokumentasi adalah runtime subagent.

Daftar periksa prasyarat

• Sebelum menyalahkan OpenClaw, pastikan /acp doctor melaporkan backend yang aktif dan sehat, ID target diizinkan oleh acp.allowedAgents bila daftar izin itu disetel, dan perintah harness benar-benar dapat dimulai di host Gateway. Masing-masing punya teks error sendiri, bukan satu kegagalan generik, jadi pesan yang Anda terima sudah mempersempit penyebabnya.
• Autentikasi penyedia harus sudah ada di host untuk harness yang Anda tuju: claude, codex, gemini, opencode, droid, dan lainnya masing-masing memiliki login sendiri. Error autentikasi vendor berarti OpenClaw sehat dan CLI atau penyedia target hanya belum login, yang Anda perbaiki dengan login atau dengan menyediakan kunci penyedia di lingkungan host Gateway, bukan dengan mengedit konfigurasi OpenClaw.
• Model yang dipilih harus ada untuk harness tersebut, karena ID model tidak portabel antar-harness, dan kontrol model bergantung pada kapabilitas adaptor: harness yang tidak mengiklankan kapabilitas ACP models maupun flag model saat startup miliknya sendiri sama sekali tidak dapat dipaksa memakai suatu model. Direktori cwd yang diminta harus ada dan dapat diakses, atau hilangkan saja dan biarkan backend memakai default-nya.

Satu hal menentukan pilihan sebelum Anda menulis konfigurasi apa pun: alat plugin OpenClaw dan alat bawaan OpenClaw tidak diekspos ke harness ACP secara default, dan dua jembatan MCP yang mengubah hal itu bersifat eksplisit dan nonaktif secara default. Jika yang Anda inginkan adalah eksekusi terdelegasi yang native OpenClaw dengan alat milik OpenClaw sendiri, itu adalah eksekusi sub-agen OpenClaw, dengan kunci sesi dan perintah slash sendiri; jika Anda hanya menginginkan CLI AI lokal sebagai model cadangan khusus teks, backend CLI OpenClaw bukan ACP dan bukan pula runtime harness, tanpa alat OpenClaw dan tanpa kontrol ACP.

Tujuh belas ID target harness

Dengan backend acpx, inilah ID yang Anda berikan ke /acp spawn atau ke sessions_spawn sebagai agentId: claude, codex, copilot, cursor, droid, fast-agent, gemini, iflow, kilocode, kimi, kiro, mux, opencode, openclaw, qoder, qwen, dan trae. claude memerlukan autentikasi Claude Code di host, copilot memerlukan login Copilot CLI atau runtime, cursor menjalankan cursor-agent acp, droid memerlukan autentikasi Factory atau Droid atau FACTORY_API_KEY di lingkungan harness, gemini memerlukan autentikasi Gemini CLI atau penyiapan kunci API, opencode memerlukan autentikasi OpenCode CLI atau penyedia, dan openclaw adalah jembatan Gateway yang memungkinkan harness yang mendukung ACP berbicara kembali ke sesi Gateway OpenClaw. codex adalah jalur cadangan ACP yang eksplisit, yang hanya digunakan saat jalur native /codex tidak tersedia atau saat ACP diminta berdasarkan nama. pi juga terdaftar di backend acpx, tetapi bukan harness coding dalam arti yang sama. Setiap spawn masuk ke tugas latar belakang OpenClaw, dan mode izin OpenClaw adalah tempat pengaturan tingkat harness berada di samping persetujuan exec OpenClaw: sesi ACP tidak memiliki TTY interaktif, sehingga pekerjaan coding yang banyak menulis dan mengeksekusi biasanya memerlukan profil yang dapat berjalan secara headless.

Di Diali

Diali meng-hosting OpenClaw untuk Anda, dan setiap pelanggan menjalankan asistennya sendiri, bukan sepotong dari asisten bersama. Konfigurasi runtime dihasilkan dari dasbor dan diganti pada setiap rilis, sehingga kunci kebijakan ditulis untuk Anda, bukan diedit manual di server yang harus Anda ingat-ingat. State disimpan di volume persisten, yang membuat sesi beserta riwayatnya tetap bertahan setelah pembaruan; snapshot harian dan pemulihan sekali klik tersedia melalui add-on Cadangan (sudah termasuk di Max). OpenClaw yang di-hosting di Diali menjelaskan apa saja yang dicakup runtime yang di-hosting, dan harga Diali memuat paket-paketnya.

• Dua perintah untuk menginstal acpx, lalu /acp doctor sebelum hal lain.
• Panduan ACP yang tersembunyi berarti ada syarat yang gagal, bukan fitur yang hilang.
• Tujuh belas ID harness, masing-masing dengan login sendiri di host.