OpenAB Codex

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

Template ini men-deploy varian Codex (openab-codex) yang menggunakan codex-acp sebagai backend agen.

Catatan Penting

• Tag image: Template ini menggunakan versi yang dipin (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 berjalan langsung sebagai pengguna node (uid 1000). Jika mengalami masalah izin pada volume persisten, restart layanan.

Pengaturan

1. Dapatkan Discord Bot Token

1. Buka https://discord.com/developers/applications dan klik New Application
2. Buka tab Bot → klik Reset Token → salin token
3. Di halaman yang sama, scroll ke bawah dan aktifkan Message Content Intent di Privileged Gateway Intents
4. 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
5. Salin URL yang dihasilkan dan buka di browser untuk mengundang Bot ke server Anda

2. Autentikasi (pilih salah satu)

Opsi A: OpenAI API Key (tagihan per token — lihat harga)

1. Buka platform.openai.com/api-keys
2. Klik Create new secret key → salin key
3. Isi OpenAI API Key saat deploy
4. Layanan otomatis menjalankan codex login --with-api-key saat pertama kali boot — tidak perlu langkah manual

Opsi B: Langganan ChatGPT (Plus/Pro/Business — penggunaan termasuk dalam paket)

1. Kosongkan OpenAI API Key saat deploy
2. Setelah layanan berjalan, buka Zeabur Dashboard → Layanan → Exec
3. Terminal Exec terbuka sebagai root. Tentukan HOME yang benar agar kredensial tersimpan di lokasi yang tepat:

   HOME=/home/node codex login --device-auth
   

4. Buka URL yang ditampilkan di terminal, otorisasi dengan akun ChatGPT
5. Restart layanan dari Dashboard
6. Kredensial disimpan di /home/node/.codex/auth.json pada volume persisten dan diperbarui otomatis — langkah ini hanya diperlukan sekali

3. Dapatkan ID Channel Discord

1. Buka Discord → Pengaturan Pengguna (ikon roda gigi) → Lanjutan → aktifkan Mode Pengembang
2. Klik kanan channel tempat Anda ingin Bot merespons → Salin ID Channel
3. 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.

1. Buka https://api.slack.com/apps → Create New App → From scratch
2. Socket Mode → Aktifkan → buat App-Level Token dengan scope connections:write → salin token xapp-... (SLACK_APP_TOKEN)
3. Event Subscriptions → Aktifkan → tambahkan bot events: app_mention, message.channels, message.groups
4. 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
5. Install App → Install ke workspace → salin token xoxb-... (SLACK_BOT_TOKEN)
6. 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 Codex yang persisten (TTL 24 jam secara default)

Kustomisasi

File	Deskripsi
/home/node/.config/openab/config.toml	Konfigurasi OpenAB (sessions, reactions, STT, dll.)

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 dan Slack Bot Token saat deploy. Layanan akan tidur tanpa crash.

Tautan

• OpenAB GitHub
• Agent Client Protocol
• OpenAI Platform