openclaw-opencode-bridge

Language: English

Bridge untuk menghubungkan channel OpenClaw ke OpenCode lewat command prefix seperti /cc atau @cc.

Pesan dari user akan langsung dieksekusi oleh OpenCode CLI (opencode run), lalu hasilnya dikirim balik lewat openclaw message send.

⚠️ Fokus pengujian saat ini adalah Telegram. Channel lain mungkin butuh penyesuaian format.

Donasi

Kalau project ini membantu, kamu bisa dukung lewat:

0xe81c32383C8F21A14E6C2264939dA512e9F9bb42

Fitur Utama

• Prefix command: @cc, /cc, @ccn, /ccn, @ccu, @ccm, @ccms
• Reply OpenCode dikirim otomatis ke user lewat channel OpenClaw
• Output dibersihkan dari noise terminal/tool logs
• Timeout bersifat batas maksimum, bukan delay tetap
• Dukungan onboarding/uninstall otomatis

Alur Kerja Singkat

1. User kirim pesan ber-prefix, contoh: /cc buat script python.
2. Plugin menangkap pesan dan menahan reply default gateway.
3. Script bridge menjalankan opencode run.
4. Hasil OpenCode dikirim balik ke user melalui openclaw message send.

Prasyarat

Dependency	Install
OpenClaw	npm i -g openclaw
OpenCode	npm i -g opencode-ai
tmux	Auto-installed during onboard if missing

Sistem operasi yang didukung: Linux dan macOS.

Instalasi Cepat

npm i -g openclaw-opencode-bridge
openclaw-opencode-bridge onboard

Wizard onboarding akan mengatur plugin, script, AGENTS.md, daemon, dan konfigurasi channel.

Tes awal:

/cc hello

Daftar Perintah

Prefix	Fungsi
@cc · /cc	Lanjut ke sesi terbaru (--continue)
@ccn · /ccn	Jalankan sesi baru tanpa --continue (konteks fresh)
@ccu · /ccu	Tampilkan statistik pemakaian OpenCode
@ccm · /ccm	Tampilkan daftar model OpenCode
@ccms · /ccms	Ganti model OpenCode (nomor atau model-id)

Contoh:

/cc refactor auth module dan tambah unit test
/ccn review PR ini: https://github.com/org/repo/pull/42
/ccu

Perilaku Timeout

• /cc memakai timeout adaptif dengan base 300s dan maksimum 600s.
• /ccn memakai timeout adaptif dengan base 300s dan maksimum 600s.
• Timeout adalah batas maksimal proses. Kalau OpenCode selesai lebih cepat, reply langsung dikirim saat itu juga.

Catatan Sesi

• /ccn tidak menghapus semua history OpenCode.
• /cc biasanya melanjutkan sesi terbaru.
• Data sesi OpenCode tersimpan di direktori data OpenCode user (contoh Linux: ~/.local/share/opencode).

Migrasi dari Versi Lama

Versi 2+ menggantikan sistem skill/hook lama menjadi plugin OpenClaw tunggal:

npm i -g openclaw-opencode-bridge
openclaw-opencode-bridge onboard

Komponen legacy akan dibersihkan otomatis saat onboarding.

Uninstall

openclaw-opencode-bridge uninstall

Ini akan menghapus plugin, script bridge, AGENTS.md hasil instalasi bridge, dan daemon.

Troubleshooting

Gejala	Solusi
Gateway LLM tetap membalas	Jalankan openclaw gateway restart
Ada “OpenCode will reply shortly” tapi tidak ada balasan akhir	Cek log /tmp/opencode-bridge-send.log lalu ulangi openclaw-opencode-bridge onboard
Perintah lambat/timeout	Cek prompt terlalu berat, lihat log bridge, pastikan OpenCode CLI normal
Output aneh/berantakan	Ulangi onboarding agar script/plugin terbaru terpasang

Attribution

Proyek ini diadaptasi dari karya original: https://github.com/bettep-dev/openclaw-claude-bridge

License

MIT