OpenAB Telegram

一键部署的 OpenAB Telegram bot — 单一 unified 服务，OAB 主程序直接内置 Telegram webhook server（unified mode，v0.9.0+）。只需填入 Telegram Bot Token。

无需独立 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，然后重启服务。

想换不同的 agent 后端？

本模板使用 Kiro 作为 agent。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，请改部署对应的 bot template。

想用其他通讯平台？

Unified mode 直接以环境变量在同一服务启用其他平台：LINE（LINE_CHANNEL_SECRET）、飞书/Lark（FEISHU_APP_ID）、Google Chat（GOOGLE_CHAT_ENABLED=true）、MS Teams（TEAMS_APP_ID）、WeCom（WECOM_CORP_ID）。各平台设置请见 OpenAB 文档。

链接

• OpenAB GitHub
• Telegram 设置指南