OpenAB Telegram Bundle

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

部署内容

服务	用途	公开
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 指令可手动执行。

想换不同的 agent 后端？

本 bundle 默认使用 Kiro。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，请改部署对应的 bot template 搭配独立的 OpenAB Gateway。

想用其他通讯平台？

请参考 OpenAB Gateway，支持 LINE、飞书/Lark、Google Chat、MS Teams、WeCom。

链接

• OpenAB GitHub