logo
icon

OpenAB Kiro

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. Template ini menggunakan Kiro CLI sebagai backend agen. Sumber: https://github.com/openabdev/openab

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

Layanan

service icon

openab

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

OpenAB Kiro

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 Kiro menggunakan image dasar openab dengan kiro-cli 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/agent di-mount sebagai volume persisten. Plugin, pengaturan, config, dan kredensial dipertahankan antar restart.
  • Izin file: Container dimulai sebagai root dan beralih ke pengguna agent (uid 1000) sebelum menjalankan openab. Jika mengalami masalah izin, restart layanan — izin diperbaiki secara otomatis saat boot.

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. 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

3. Dapatkan Kiro API Key (hanya paket Pro/Pro+/Power)

Jika Anda memiliki langganan Kiro berbayar, buka kiro.dev → Settings → API Keys, buat key dan masukkan ke variabel KIRO_API_KEY. Layanan akan otentikasi secara otomatis tanpa langkah manual setelah deploy.

Pengguna paket gratis dapat mengosongkan KIRO_API_KEY dan autentikasi setelah deploy di langkah 5.

4. Deploy

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

5. Autentikasi Kiro via Device Flow (hanya paket gratis)

Lewati langkah ini jika Anda mengisi KIRO_API_KEY di langkah 3.

Setelah layanan berjalan, buka terminal layanan di Zeabur Dashboard dan jalankan:

runuser -u agent -- kiro-cli login --use-device-flow

ℹ️ runuser -u agent menjalankan login sebagai pengguna agent, sehingga kredensial dimiliki oleh pemilik yang benar sejak awal — tanpa chown atau restart.

Ikuti URL dan kode di layar untuk menyelesaikan otorisasi device flow di browser Anda. Percakapan baru akan otomatis menggunakan autentikasi baru — restart hanya diperlukan jika Anda ingin membatalkan sesi yang masih berjalan di memori.

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 Kiro yang persisten (TTL 24 jam secara default)

Kustomisasi

FileDeskripsi
/home/agent/.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/agent/.config/openab/config.toml

Untuk opsi konfigurasi, lihat dokumentasi OpenAB.

Menonaktifkan

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

Tautan