logo
icon

OpenAB Codex

Open Agent Broker — harness Rust yang ringan untuk menjembatani Discord dan Slack ke CLI coding yang kompatibel dengan ACP (Claude Code, Codex, Gemini, Kiro) melalui stdio JSON-RPC. Sumber: https://github.com/openabdev/openab

template cover
Dideploy47 kali
PenerbitzeaburZeabur
Dibuat2026-04-19
SumberLihat Sumber
Minimum2 Core4 GB
Direkomendasikan4 Core8 GB
Tag
AIDeveloper ToolsDiscordSlack

Layanan

service icon

openab

ghcr.io/openabdev/openab-codex:0.8.3-beta.4

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.3-beta.4). 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. Jalankan login sebagai pengguna node agar kredensial dimiliki oleh node sejak awal: 
    runuser -u node -- codex login --device-auth
  4. Buka URL yang ditampilkan di terminal, otorisasi dengan akun ChatGPT
  5. Kredensial disimpan di /home/node/.codex/auth.json pada volume persisten dan diperbarui otomatis — percakapan baru langsung mengambil autentikasi baru, tidak perlu restart (restart hanya diperlukan jika ingin membatalkan sesi yang masih berjalan di memori). 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.

Tambahkan Platform Pesan (Telegram / LINE / Feishu / Google Chat / MS Teams)

Untuk menjembatani Telegram, LINE, Feishu/Lark, Google Chat, atau MS Teams, deploy template OpenAB Gateway di proyek Zeabur yang sama. Kemudian tambahkan variabel lingkungan berikut ke layanan ini:

  • GATEWAY_URL = ws://openab-gateway:8080/ws
  • GATEWAY_PLATFORM = salah satu dari telegram, line, feishu, googlechat, teams

Restart layanan. Skrip startup otomatis menyuntikkan blok [gateway] ke config.toml.

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

FileDeskripsi
/home/node/.config/openab/config.tomlKonfigurasi 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