OpenAB LINE Bundle

一鍵部署的 OpenAB LINE bot — bot agent 與 webhook gateway 打包在一起，只需填入 LINE channel 憑證，並把 webhook URL 貼進 LINE Developers Console 一次。

部署內容

服務	用途	公開
openab	執行 Kiro CLI 的 OAB agent	否
openab-gateway	LINE webhook → WebSocket 橋接	是（自動 HTTPS）

無需共用 PVC、無需手動修改 config.toml。Agent 的 config.toml 在首次啟動時自動生成，gateway URL 已預先設為 ws://openab-gateway:8080/ws、platform = "line"。

設定步驟

1. 建立 LINE Official Account + Channel

1. 至 LINE Official Account Manager → 建立新帳號（或使用既有的）。
2. 設定 → Messaging API → 啟用 Messaging API → 依提示完成（可能需要建立 / 選擇 LINE Developers provider）。
3. 開啟 LINE Developers Console → 你的 provider → 你的 channel。
4. Basic settings tab → 滑到 Channel secret → 複製 → 貼到 LINE Channel Secret。
5. Messaging API tab → 滑到 Channel access token → 點 Issue → 複製長效 token → 貼到 LINE Channel Access Token。
6. 同樣在 Messaging API tab：
   • Auto-reply messages：關閉（避免 LINE 自動回覆搶在 bot 之前）
   • Greeting messages：選填

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. 註冊 LINE Webhook URL

LINE 沒有 setWebhook API——必須手動把 URL 貼到 LINE Developers Console 一次。

1. 打開 openab-gateway 服務頁面 → 查自動分配的網域（例如 https://your-gateway.zeabur.app）。
2. 完整 webhook URL 為：https://<你的_GATEWAY_網域>/webhook/line
3. 至 LINE Developers Console → 你的 channel → Messaging API tab。
4. Webhook URL → Edit → 貼上 URL → Update。
5. Use webhook → 切換為 ON。
6. 按 Verify — 應看到 ✅ Success。

openab-gateway 服務 Instructions 區會顯示已自動填好的完整 webhook URL，可直接複製。

6. 測試

在 LINE app 內掃 channel 的 Messaging API 頁面上的 QR code 加 bot 為好友，發訊息。Gateway 收到後透過 WebSocket 轉發給 OAB，OAB 處理後透過 Gateway 回覆。

群組對話：LINE bot 可以被邀請進群組。群組行為取決於 LINE Official Account Manager → Response settings 的設定。

自訂設定

• /home/agent/.config/openab/config.toml — OAB 設定（sessions、reactions 等）。首次啟動時從內建範本建立，[gateway] 區塊已預先設好。如需重建，刪除檔案後重啟服務。
• 映像標籤 — bot 追蹤 floating stable 標籤（ghcr.io/openabdev/openab:stable），OpenAB 推出新穩定版時自動更新。Gateway 目前 pin 在 ghcr.io/openabdev/openab-gateway:0.5.1（尚未發布 :stable 標籤）。可至 Zeabur Dashboard → 服務 → 設定修改映像標籤。
• Reply token 快取 — LINE reply token 約 1 分鐘過期，gateway 自動快取並在 token 過期 / 缺失時 fallback 到 push API，不需設定。

為什麼 webhook 沒有自動註冊？

不像 Telegram 有 setWebhook API，LINE 規定你必須在 Developers Console 自己貼 URL 並按 Verify——沒有 server-to-server 註冊端點。這只需做一次；後續 redeploy 只要 gateway 網域沒變，URL 就持續有效。

想換不同的 agent 後端？

本 bundle 預設使用 Kiro。若想用 Claude / Codex / Cursor / Gemini / OpenCode / Hermes / Grok，請改部署對應的 bot template 搭配獨立的 OpenAB Gateway。

想用其他通訊平台？

請參考 OpenAB Telegram Bundle / Feishu Bundle 或獨立的 OpenAB Gateway，支援 Google Chat、MS Teams、WeCom。

連結

• OpenAB GitHub
• LINE 設定指南
• 獨立 OpenAB Gateway 模板