OpenAB Telegram Bundle

一鍵部署的 OpenAB Telegram bot — bot agent 與 webhook gateway 打包在一起，只需填入 Telegram Bot Token 即可使用。

Telegram ──POST──▶ ┌──────────────────┐ ◀──WebSocket── ┌────────────┐
                   │  openab-gateway  │                │   openab   │
                   │  （僅 Telegram） │                │ （Kiro CLI）│
                   └──────────────────┘                └────────────┘
                      公開 HTTPS                          內部使用

部署內容

服務	用途	公開
openab	執行 Kiro CLI 的 OAB agent	否
openab-gateway	Telegram webhook → WebSocket 橋接	是（自動 HTTPS）

無需共用 PVC、無需手動修改 config.toml。Agent 的 config.toml 在首次啟動時自動生成，gateway URL 已預先設為 ws://openab-gateway:8080/ws、platform = "telegram"。

設定步驟

1. 建立 Telegram Bot

1. 在 Telegram 開啟 @BotFather
2. 發送 /newbot 並依照提示操作
3. 你設定的 username（例如 my_zeabur_bot，必須以 bot 結尾）→ 貼到 Bot Username
4. 產生的 bot token（例如 123456:ABC-DEF...）→ 貼到 Telegram Bot Token
5. 群組 / supergroup 使用：發送 /setprivacy → Disable，讓 Bot 可以看到所有訊息（@mention 判定需要此設定）
6. Supergroup 含 forum topic（自動「每段對話一個 thread」）：把 bot 加入群組 → 群組設定 → 管理員 → 開啟 Manage Topics 權限

2. （選填）取得 Kiro API Key

如果你有付費的 Kiro 訂閱，前往 kiro.dev → Settings → API Keys 建立 key，填入 KIRO_API_KEY。免費方案跳過此步驟，於步驟 4 部署後再認證。

3. 部署

點擊部署。系統會自動分配公開 HTTPS 網域給 gateway 服務。

4. 透過 Device Flow 認證 Kiro（僅免費方案）

若步驟 2 已填入 KIRO_API_KEY，跳過此步驟。

待 openab 服務啟動後，於 Zeabur Dashboard 開啟該服務的終端機，執行：

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

依照畫面顯示的 URL 與 code 完成瀏覽器授權。

5. 測試

向你的 Telegram Bot 發送訊息。Gateway 收到後透過 WebSocket 轉發給 OAB，OAB 處理後透過 Gateway 回覆。

Telegram webhook 由 openab-gateway 服務的 init container 在啟動時自動註冊——於 gateway log 找 openab-gateway: telegram webhook registered → https://... 確認。不需要手動跑 curl setWebhook。

若日後需要重新觸發（例如 revoke bot token 後、或更換 gateway 網域），可至 openab-gateway 服務頁面 → Instructions 區，已預填好的 Re-register Telegram Webhook curl 指令可手動執行。

自訂設定

• /home/agent/.config/openab/config.toml — OAB 設定（sessions、reactions 等）。首次啟動時從內建範本建立，[gateway] 區塊已預先設好。如需重建，刪除檔案後重啟服務。
• 映像標籤 — bot 追蹤 floating stable 標籤（ghcr.io/openabdev/openab:stable），OpenAB 推出新穩定版時自動更新。Gateway 目前 pin 在 ghcr.io/openabdev/openab-gateway:0.5.1（尚未發布 :stable 標籤）。若要 pin 至特定版本或手動升版，請至 Zeabur Dashboard → 服務 → 設定修改映像標籤。可用標籤：OpenAB / Gateway。

想換不同的 agent 後端？

本 bundle 預設使用 Kiro。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，請改部署對應的 bot template 搭配獨立的 OpenAB Gateway。

想用其他通訊平台？

請參考 OpenAB Gateway，支援 LINE、Feishu/Lark、Google Chat、MS Teams、WeCom。

連結

• OpenAB GitHub
• Telegram 設定指南
• 獨立 OpenAB Gateway 模板