OpenAB

OpenAB adalah harness Rust yang ringan dan open-source yang menjembatani Discord ke CLI coding yang kompatibel dengan Agent Client Protocol melalui stdio JSON-RPC.

Template ini men-deploy varian Claude (openab-claude) yang menggunakan claude-agent-acp sebagai backend agen.

Catatan Penting

Tag image: Template ini menggunakan versi tetap (0.8.1-beta.5). Untuk upgrade, ubah tag image di Zeabur Dashboard → Layanan → Pengaturan. Tag yang tersedia: GitHub Packages.
Penyimpanan persisten: /home/node di-mount sebagai volume persisten. Plugin, pengaturan, config, dan kredensial dipertahankan antar restart.
Izin file: Container dimulai sebagai root dan beralih ke pengguna node (uid 1000) sebelum menjalankan openab. Jika mengalami masalah izin, restart layanan — izin diperbaiki secara otomatis saat boot.

Pengaturan

1. Dapatkan Discord Bot Token

Buka https://discord.com/developers/applications dan klik New Application
Buka tab Bot → klik Reset Token → salin token
Di halaman yang sama, scroll ke bawah dan aktifkan Message Content Intent di Privileged Gateway Intents
Buka OAuth2 → URL Generator → centang scope bot → centang izin: Send Messages, Send Messages in Threads, Create Public Threads, Read Message History, Add Reactions, Manage Messages
Salin URL yang dihasilkan dan buka di browser untuk mengundang Bot ke server Anda

2. Dapatkan Auth Token (pilih salah satu)

Metode	Cara mendapatkan
Anthropic API Key	Buka console.anthropic.com/settings/keys → Create Key → salin kunci `sk-ant-api...`
Zeabur AI Hub Token	Buka Zeabur AI Hub → API Keys → Create → salin token
Claude OAuth Token	Jalankan `claude setup-token` di terminal (memerlukan langganan Claude Pro/Max/Team/Enterprise) → buka URL yang ditampilkan → otorisasi → tempel kode → salin token `sk-ant-oat...` yang dihasilkan

3. Dapatkan ID Channel Discord

Buka Discord → Pengaturan Pengguna (ikon roda gigi) → Lanjutan → aktifkan Mode Pengembang
Klik kanan channel tempat Anda ingin Bot merespons → Salin ID Channel
Untuk beberapa channel, pisahkan dengan koma: 123456789012345678,234567890123456789

4. Deploy

Isi variabel dan klik deploy. Layanan akan terhubung ke Discord dan/atau Slack secara otomatis.

Pengaturan Slack (Opsional)

OpenAB mendukung Slack melalui Socket Mode — tidak perlu URL publik.

Buka https://api.slack.com/apps → Create New App → From scratch
Socket Mode → Aktifkan → buat App-Level Token dengan scope connections:write → salin token xapp-... (SLACK_APP_TOKEN)
Event Subscriptions → Aktifkan → tambahkan bot events: app_mention, message.channels, message.groups
OAuth & Permissions → Bot Token Scopes → tambahkan: app_mentions:read, chat:write, channels:history, groups:history, channels:read, groups:read, reactions:write, files:read, users:read
Install App → Install ke workspace → salin token xoxb-... (SLACK_BOT_TOKEN)
Di setiap channel Slack yang ingin menggunakan bot, jalankan /invite @YourAppName

Isi SLACK_BOT_TOKEN dan SLACK_APP_TOKEN sebelum deploy. Discord dan Slack dapat berjalan bersamaan.

Penggunaan

@mention bot di channel Discord atau Slack yang diizinkan untuk memulai percakapan
OpenAB membuat thread untuk percakapan multi-giliran — tidak perlu @mention untuk pesan selanjutnya
Setiap thread dipetakan ke sesi Claude yang persisten (TTL 24 jam secara default)

Kustomisasi

File	Deskripsi
`/home/node/CLAUDE.md`	Instruksi agent — Claude membacanya di setiap sesi
`/home/node/.config/openab/config.toml`	Konfigurasi OpenAB (sessions, reactions, STT, dll.)
`/etc/claude-code/managed-settings.json`	Mode izin Claude Code

config.toml dibuat dari template bawaan saat boot pertama. Setelah itu, edit file secara langsung — variabel lingkungan hanya digunakan untuk pengaturan awal. Untuk mengembalikan ke default, hapus dan restart: rm /home/node/.config/openab/config.toml

Untuk opsi konfigurasi, lihat dokumentasi OpenAB.

Menonaktifkan

Kosongkan Discord Bot Token saat deploy. Layanan akan tidur tanpa crash.

OpenAB Claude

Layanan

openab