OpenAB Telegram

一鍵部署的 OpenAB Telegram bot — 單一 unified 服務，OAB 主程式直接內建 Telegram webhook server（unified mode，v0.9.0+）。只需填入 Telegram Bot Token。

Telegram ──POST──▶ ┌──────────────────────────────┐
                   │  openab (:8080/webhook/telegram) ──▶ Kiro CLI
                   └──────────────────────────────┘
                      公開 HTTPS，單一服務

無需獨立 gateway 服務、無需共用 PVC、無需手動修改 config.toml。設定 TELEGRAM_BOT_TOKEN 環境變數即自動啟用 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 網域給服務。

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 發送訊息。

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

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

存取控制

預設任何人都可以與 Bot 互動（TELEGRAM_ALLOW_ALL_USERS=true）。如需限制，設定 TELEGRAM_ALLOW_ALL_USERS=false 並在 TELEGRAM_ALLOWED_USERS 填入逗號分隔的 Telegram 用戶 ID，然後重啟服務。

自訂設定

• /home/agent/.config/openab/config.toml — OAB 設定（sessions、reactions 等）。首次啟動時從內建範本建立。如需重建，刪除檔案後重啟服務。
• 映像標籤 — 追蹤 floating beta 標籤（ghcr.io/openabdev/openab:beta-kiro），每次推出新 beta 版時自動更新。正式環境建議切換至 stable。若要 pin 至特定版本或手動升版，請至 Zeabur Dashboard → 服務 → 設定修改映像標籤。可用標籤：GitHub Packages。

想換不同的 agent 後端？

本模板使用 Kiro 作為 agent。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，請改部署對應的 bot template。

想用其他通訊平台？

Unified mode 直接以環境變數在同一服務啟用其他平台：LINE（LINE_CHANNEL_SECRET）、Feishu/Lark（FEISHU_APP_ID）、Google Chat（GOOGLE_CHAT_ENABLED=true）、MS Teams（TEAMS_APP_ID）、WeCom（WECOM_CORP_ID）。各平台設定請見 OpenAB 文件。

連結

• OpenAB GitHub
• Telegram 設定指南