OpenAB Feishu Bundle

一鍵部署的 OpenAB 飛書/Lark bot — bot agent 與 WebSocket gateway 打包在一起，只需填入飛書 App ID 與 App Secret 即可使用。

飛書開放平台 ◀──對外 WebSocket── ┌──────────────────┐ ◀──WebSocket── ┌────────────┐
                                  │  openab-gateway  │                │   openab   │
                                  │   （僅飛書）     │                │ （Kiro CLI）│
                                  └──────────────────┘                └────────────┘
                                        無公開入口                        內部使用

部署內容

服務	用途	公開
openab	執行 Kiro CLI 的 OAB agent	否
openab-gateway	飛書事件 WebSocket → OAB WebSocket 橋接	否

兩個服務都僅供內部使用——gateway 採對外連線（outbound）連到飛書開放平台，不需要 inbound webhook 或公開網域。

設定步驟

1. 建立飛書/Lark App

1. 前往 飛書開放平台（中國）或 Lark Developer（海外）
2. 建立企業自建應用 → 記下 App ID（cli_xxx）與 App Secret → 兩者貼到上方變數
3. 左側選單 → 應用功能 → 機器人 → 開啟 啟用機器人

   ⚠️ 這步很容易漏掉。沒開的話 App 無法收到訊息。

4. 左側選單 → 事件與回調 → 連線方式 → 選 WebSocket
5. 新增事件 → im.message.receive_v1
6. 左側選單 → 權限管理 → 新增：
   • im:message — 收發訊息
   • im:message.group_at_msg — 接收群組 @mention 訊息
   • im:message.group_at_msg:readonly — 讀取群組 @mention
   • im:message.p2p_msg:readonly — 讀取 DM
   • im:resource — 下載圖片/檔案
   • contact:user.base:readonly — 解析使用者顯示名稱
7. 建立版本 → 申請發布（開發階段可用測試模式）

2. （選填）取得 Kiro API Key

如果你有付費的 Kiro 訂閱，前往 kiro.dev → Settings → API Keys 建立 key，填入 KIRO_API_KEY。免費方案跳過此步驟，於步驟 4 部署後再認證。

3. 部署

點擊部署。不會分配公開網域——飛書 WebSocket 採對外連線。

4. 透過 Device Flow 認證 Kiro（僅免費方案）

若步驟 2 已填入 KIRO_API_KEY，跳過此步驟。

待 openab 服務啟動後，於 Zeabur Dashboard 開啟該服務的終端機，執行：

runuser -u agent -- kiro-cli login --use-device-flow

依照畫面顯示的 URL 與 code 完成瀏覽器授權。

5. 測試

把 bot 加入飛書群組（或直接 DM）並發送訊息。群組中需 @mention bot 才會觸發回應（預設行為）。Gateway 對外連線到飛書、收到事件後透過內部 WebSocket 轉發給 OAB，OAB 處理後透過 Gateway 回覆。

於 openab-gateway 紀錄找 feishu websocket connected 確認對外連線已建立。

自訂設定

• /home/agent/.config/openab/config.toml — OAB 設定（sessions、reactions 等）。首次啟動時從內建範本建立，[gateway] 區塊已預先設好。如需重建，刪除檔案後重啟服務。
• Lark（海外）vs 飛書（中國） — 預設為飛書（feishu.cn）。若 App 註冊在 larksuite.com，請至 Zeabur Dashboard 開啟 openab-gateway 服務 → 環境變數 → 將 FEISHU_DOMAIN 從 feishu 改為 lark 並重啟。
• 群組 @mention 行為 — 預設 true（bot 僅在被 @mention 時回應）。若要在已授權的群組中讓 bot 回應所有訊息，請於 openab-gateway 服務新增環境變數 FEISHU_REQUIRE_MENTION=false。
• 映像標籤 — bot 追蹤 floating stable 標籤（ghcr.io/openabdev/openab:stable），OpenAB 推出新穩定版時自動更新。Gateway 目前 pin 在 ghcr.io/openabdev/openab-gateway:0.5.1（尚未發布 :stable 標籤）。若要 pin 至特定版本或手動升版，請至 Zeabur Dashboard → 服務 → 設定修改映像標籤。可用標籤：OpenAB / Gateway。

想換不同的 agent 後端？

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

想用其他通訊平台？

請參考 OpenAB Gateway，支援 Telegram、LINE、Google Chat、MS Teams、WeCom。若需 Telegram 一鍵 bundle，請見 OpenAB Telegram Bundle。

連結

• OpenAB GitHub
• 飛書 Chart README
• 獨立 OpenAB Gateway 模板