OpenAB Gateway

OpenAB Gateway 是一个独立的 Webhook 桥接服务，通过 WebSocket 将 Telegram 和 LINE 连接到任何正在运行的 OpenAB 实例。

Telegram ──POST──▶ ┌──────────────────┐
LINE     ──POST──▶ │  OpenAB Gateway  │ ◀──WebSocket── OAB Pod
                   │     :8080        │   （OAB 主动向外连线）
                   └──────────────────┘

将此模板部署于现有 OpenAB 服务（Claude、Cursor、Codex 等）旁，无需重新部署 OAB 即可添加 Telegram 和 LINE 支持。

前置条件

• 同一个 Zeabur 项目中已有正在运行的 OpenAB 服务
• 至少需要以下其中一个：
  • 来自 @BotFather 的 Telegram Bot Token
  • 已启用 Messaging API 的 LINE 官方账号（LINE Channel Secret + Access Token）

设置步骤

1. 创建 Telegram Bot

1. 在 Telegram 打开 @BotFather，发送 /newbot
2. 复制 Bot Token → 粘贴到 Telegram Bot Token

2. 部署

填入 Telegram Bot Token 后点击部署。系统自动分配公开 HTTPS 域名。

3. 注册 Telegram Webhook

curl "https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://YOUR_DOMAIN/webhook/telegram"

4. 配置 OAB 使用 Gateway

在 OpenAB 服务中编辑 /home/agent/.config/openab/config.toml：

[gateway]
url = "ws://openab-gateway:8080/ws"

重启 OpenAB 服务。

LINE 设置（选填）

1. 创建 LINE 官方账号

1. 前往 LINE 官方账号管理后台 创建账号
2. 设置 → Messaging API → 启用 Messaging API
3. 打开 LINE Developers Console → 你的 Channel：
   • Basic settings → Channel secret → 复制 → 粘贴到 LINE Channel Secret
   • Messaging API → Channel access token → Issue → 复制 → 粘贴到 LINE Channel Access Token

2. 设置 Webhook URL

在 LINE Developers Console → Messaging API 标签：

1. Webhook URL → 编辑 → 输入：https://YOUR_DOMAIN/webhook/line
2. Use webhook → 开启
3. Auto-reply messages → 关闭
4. 点击 Verify

3. 配置 OAB 使用 LINE

在 config.toml 的 gateway 区块加入 platform = "line"：

[gateway]
url = "ws://openab-gateway:8080/ws"
platform = "line"

保存后重启 OpenAB 服务。

Webhook 端点

路径	平台
POST /webhook/telegram	Telegram
POST /webhook/line	LINE
GET /ws	OAB WebSocket（内部使用）
GET /health	健康检查

链接

• OpenAB GitHub
• Gateway README