OpenAB Gateway

OpenAB Gateway 是一個獨立的 Webhook 橋接服務，透過 WebSocket 將 Telegram 和 LINE 連接到任何正在運行的 OpenAB 實例。

Telegram ──POST──▶ ┌──────────────────┐
LINE     ──POST──▶ │  OpenAB Gateway  │ ◀──WebSocket── OAB Pod
                   │     :8080        │   （OAB 主動對外連線）
                   └──────────────────┘

將此 template 部署於現有 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
2. 發送 /newbot 並依照提示操作
3. 複製 Bot Token（例如 123456:ABC-DEF...）→ 貼到 Telegram Bot Token
4. 選填：發送 /setprivacy → Disable，讓 Bot 可以看到群組中所有訊息

2. 部署

填入想啟用平台的 Token 後點擊部署。系統會自動分配公開 HTTPS 網域。可以只啟用 Telegram、只啟用 LINE，或兩者同時啟用。

3. 註冊 Telegram Webhook

部署完成後，向 Telegram 註冊你的 Gateway URL（替換 YOUR_TOKEN、YOUR_DOMAIN，選填 YOUR_SECRET）：

# 不帶 webhook secret（較簡單）
curl "https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://YOUR_DOMAIN/webhook/telegram"

# 帶 webhook secret（建議 — 與 TELEGRAM_SECRET_TOKEN 一致）
curl "https://api.telegram.org/botYOUR_TOKEN/setWebhook?url=https://YOUR_DOMAIN/webhook/telegram&secret_token=YOUR_SECRET"

預期回應：{"ok":true,"result":true,"description":"Webhook was set"}

4. 設定 OAB 使用 Gateway

在同一個 Zeabur 專案的 OpenAB 服務中，編輯 /home/agent/.config/openab/config.toml 並加入：

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

儲存後重啟 OpenAB 服務。OAB 會主動對外連線到 Gateway，OAB 本身不需要開放任何 inbound 連接埠。

內部 Hostname： openab-gateway 在同一個 Zeabur 專案內透過內部 DNS 解析。若你的 Gateway 服務名稱不同，請改用對應名稱。

5. 測試

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

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
• Telegram 設定指南
• LINE 設定指南
• Gateway README