Apa Itu ACP di OpenClaw? Cara Kerja, Kapan Dipakai, dan Bedanya dengan Subagent

ACP di OpenClaw sering bikin bingung karena terdengar seperti nama model atau nama agent baru. Padahal bukan.

Secara praktis, ACP adalah jalur untuk menjalankan external coding harness atau agent runtime khusus dari OpenClaw. Ia dipakai ketika pekerjaan lebih cocok dikerjakan oleh tool seperti Claude Code, Gemini CLI, OpenCode, Cursor, atau explicit Codex ACP dalam sesi terpisah.

Jadi ACP bukan pengganti chat utama. ACP adalah mekanisme dispatch dan orkestrasi untuk menjalankan agent eksternal secara lebih terkontrol.

Ringkasan cepat

• ACP berarti Agent Client Protocol, dipakai OpenClaw untuk menjalankan harness eksternal lewat backend ACP/acpx.
• ACP cocok untuk task coding atau pekerjaan teknis panjang yang butuh runtime khusus.
• Subagent biasa adalah agent internal OpenClaw; ACP adalah jalur ke agent/harness eksternal.
• Untuk Codex, OpenClaw sekarang punya jalur native Codex juga. ACP dipakai jika memang butuh jalur ACP/acpx secara eksplisit.
• ACP sebaiknya dipakai dengan aturan permission yang jelas karena biasanya berjalan non-interaktif.

ACP itu sebenarnya apa?

Kalau disederhanakan:

ACP adalah jalur komunikasi agar OpenClaw bisa menjalankan dan mengontrol agent eksternal sebagai sesi kerja terpisah.

Analogi paling gampang:

• OpenClaw = operator utama,
• ACP = jalur dispatch,
• harness eksternal = pekerja spesialis,
• session/thread = ruang kerja pekerja itu.

Contoh harness yang bisa relevan di jalur ACP:

• Claude Code,
• Gemini CLI,
• OpenCode,
• Cursor,
• Copilot,
• explicit Codex ACP,
• atau agent lain yang didukung backend ACP/acpx.

OpenClaw tetap menjadi pusat koordinasi. Tapi eksekusi teknis bisa diberikan ke harness yang memang dirancang untuk pekerjaan tersebut.

Kenapa OpenClaw butuh ACP?

Karena tidak semua pekerjaan ideal dikerjakan langsung di chat utama.

Ada task yang:

• panjang,
• butuh banyak eksplorasi file,
• perlu menjalankan tool coding khusus,
• butuh sesi yang persistent,
• perlu dipisahkan dari percakapan utama,
• atau cocok dikerjakan sebagai background task.

Jika semuanya dipaksa masuk chat utama, percakapan cepat penuh, konteks makin berat, dan operator sulit membedakan mana diskusi, mana eksekusi.

ACP membantu membuat eksekusi lebih rapi: task teknis masuk ke sesi khusus, sementara chat utama tetap dipakai untuk instruksi, keputusan, dan laporan hasil.

Bedanya ACP dengan subagent biasa

Subagent biasa

Subagent biasa adalah agent internal yang dijalankan OpenClaw untuk membantu pekerjaan tertentu. Biasanya cocok untuk:

• riset kecil,
• analisis terpisah,
• review ringan,
• summarization,
• atau task yang tidak perlu runtime vendor/harness khusus.

Subagent ini masih berada dalam ekosistem internal OpenClaw.

ACP

ACP dipakai ketika OpenClaw perlu menjalankan runtime eksternal. Fokusnya bukan sekadar "agent tambahan", tapi menghubungkan OpenClaw ke harness yang punya cara kerja sendiri.

ACP lebih cocok untuk:

• coding task yang kompleks,
• refactor repo,
• debugging multi-file,
• tugas yang butuh persistent session,
• menjalankan Claude Code/Gemini/OpenCode/Cursor melalui adapter,
• atau workflow yang memang diminta memakai harness tertentu.

Perbedaannya ada di level runtime dan orkestrasi.

Kapan sebaiknya pakai ACP?

Pakai ACP ketika task punya salah satu ciri ini:

1. User secara eksplisit minta harness tertentu

Misalnya: "pakai Claude Code", "pakai Gemini CLI", "pakai OpenCode", atau "jalanin via ACP".

2. Task coding cukup panjang

Contoh:

• audit repo,
• refactor banyak file,
• implementasi fitur,
• review PR,
• migrasi struktur project,
• atau debugging yang butuh iterasi.

3. Butuh session yang bisa dilanjutkan

Untuk task yang belum selesai dalam satu putaran, sesi persistent lebih masuk akal daripada mulai dari nol setiap kali.

4. Chat utama harus tetap bersih

Kalau eksekusi menghasilkan banyak log, diff, error, dan percobaan, lebih baik dipisahkan.

5. Harness eksternal punya kemampuan yang dibutuhkan

Misalnya harness tertentu lebih cocok untuk code editing, repo navigation, atau flow tool tertentu.

Kapan tidak perlu ACP?

ACP tidak harus dipakai untuk semua hal.

Jangan pakai ACP jika:

• task hanya pertanyaan singkat,
• cukup dijawab langsung,
• perubahan file hanya satu-dua baris,
• tidak butuh harness eksternal,
• atau justru lebih cepat dikerjakan OpenClaw langsung.

Overusing ACP bisa bikin workflow lebih lambat dan ribet. Prinsipnya: pakai ACP saat ada kebutuhan runtime eksternal, bukan karena istilahnya terdengar lebih canggih.

Bagaimana flow ACP di chat?

Flow sederhana biasanya seperti ini:

1. User memberi instruksi di chat utama.
2. OpenClaw membaca bahwa task cocok untuk ACP atau user eksplisit minta ACP.
3. OpenClaw membuat sesi ACP dengan agent/harness yang sesuai.
4. Harness mengerjakan task dalam sesi terpisah.
5. Hasil akhir dikembalikan ke chat utama.
6. Jika sesi persistent, sesi bisa dilanjutkan untuk revisi berikutnya.

Di platform seperti Discord, ACP bisa dibuat thread-bound agar pembahasan teknis tidak mengganggu channel utama. Untuk direct chat, ACP bisa berjalan sebagai background session yang tetap dilaporkan hasilnya ke percakapan.

Catatan penting tentang Codex

Ini bagian yang sering rancu.

Di OpenClaw modern, Codex bisa punya jalur native sendiri. Artinya, untuk banyak kebutuhan Codex, jalur native Codex bisa lebih tepat daripada ACP.

ACP untuk Codex dipakai kalau instruksinya memang explicit ACP, misalnya ingin menjalankan Codex melalui adapter ACP/acpx tertentu.

Jadi keputusan sehatnya:

• Codex native untuk workflow Codex default jika tersedia dan sesuai.
• ACP Codex jika user minta ACP eksplisit atau butuh jalur acpx.
• Subagent biasa jika tugasnya cukup internal dan tidak perlu harness eksternal.

Permission dan risiko operasional

ACP session biasanya berjalan non-interaktif. Artinya, kalau harness butuh approval manual di tengah jalan, session bisa macet atau gagal jika permission belum diatur.

Karena itu, sebelum ACP dipakai untuk production workflow, pastikan:

• permission mode jelas,
• tool apa saja yang boleh dipakai jelas,
• write/exec policy tidak terlalu longgar tanpa alasan,
• repo/folder kerja benar,
• dan output final diverifikasi sebelum dianggap selesai.

ACP itu kuat, tapi kekuatan ini harus dibatasi dengan scope yang jelas.

Untuk task coding production, jangan hanya lihat apakah agent "selesai". Cek juga:

• file apa yang berubah,
• test/lint/build apa yang dijalankan,
• apakah ada command berbahaya,
• apakah perubahan sesuai scope,
• dan apakah hasilnya bisa di-rollback.

Contoh keputusan praktis

Kasus 1: "Tolong jelaskan error ini"

Tidak perlu ACP. Jawab langsung atau cek log seperlunya.

Kasus 2: "Refactor modul checkout, cek test, lalu buka PR"

Cocok untuk ACP atau coding harness, karena task multi-step dan butuh repo exploration.

Kasus 3: "Buat ringkasan meeting 10 poin"

Subagent biasa atau jawaban langsung cukup.

Kasus 4: "Pakai Claude Code untuk audit repo ini"

ACP/harness route cocok karena user eksplisit minta external coding agent.

Kasus 5: "Fix typo di satu file"

Tidak perlu ACP. Edit langsung lebih efisien.

Kesimpulan operasional

ACP di OpenClaw adalah jalur untuk menjalankan external agent/harness dalam sesi yang rapi. Ia berguna untuk pekerjaan teknis panjang, coding task kompleks, dan workflow yang memang butuh runtime khusus.

Tapi ACP bukan jawaban untuk semua task. Subagent biasa tetap berguna untuk delegasi internal, dan jawaban langsung tetap paling efisien untuk hal sederhana.

Rule praktisnya:

• kalau task sederhana, kerjakan langsung;
• kalau butuh delegasi internal, pakai subagent;
• kalau butuh harness eksternal atau user minta tool coding tertentu, pakai ACP;
• kalau pakai Codex dan jalur native tersedia, gunakan native kecuali ACP memang diminta.

Dengan pembagian ini, OpenClaw tidak cuma "bisa menjalankan banyak agent", tapi punya sistem kerja yang lebih bersih: chat utama untuk keputusan, subagent untuk delegasi internal, dan ACP untuk eksekusi spesialis.

Jika Anda ingin setup OpenClaw dengan ACP, Codex, permission, dan workflow coding yang rapi untuk tim, lihat juga halaman layanan jasa install OpenClaw agar arsitekturnya tidak asal jalan, tapi siap dipakai operasional.