OpenAB Gemini

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 Gemini (openab-gemini) yang menggunakan gemini --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 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

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 Kunci API Gemini

1. Buka Google AI Studio
2. Klik Create API key
3. Salin kunci API yang dihasilkan

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 template dan klik deploy. Layanan akan terhubung ke Discord secara otomatis.

Penggunaan

• @mention bot di channel yang diizinkan untuk memulai percakapan
• OpenAB membuat thread untuk percakapan multi-giliran -- tidak perlu @mention untuk pesan selanjutnya
• Setiap thread dipetakan ke sesi Gemini 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.

Webhook / Integrasi Bot

Secara default, openab mengabaikan pesan dari bot dan webhook lain. Untuk mengizinkan pesan yang dipicu webhook (misalnya pengujian otomatis atau pipeline CI), tambahkan berikut ke config.toml:

[discord]
allow_bot_messages = "mentions"

Dengan pengaturan ini, openab merespons pesan bot atau webhook apa pun yang @mention-nya. Untuk membatasi ke webhook tertentu, tambahkan juga:

trusted_bot_ids = ["YOUR_WEBHOOK_USER_ID"]

ID pengguna webhook adalah ID numerik dalam URL webhook: https://discord.com/api/webhooks/<ID>/...

Menonaktifkan

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

Tautan

• OpenAB GitHub
• Agent Client Protocol
• Google AI Studio