OpenAB Feishu/Lark Bundle

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

Feishu/Lark ◀──Long Connection──▶ ┌──────────────────┐ ◀──WebSocket── ┌────────────┐
              （gateway 主動連） │  openab-gateway  │                │   openab   │
                                 │ （僅 Feishu）    │                │ （Kiro CLI）│
                                 └──────────────────┘                └────────────┘
                                      內部使用                          內部使用

不需要 public HTTPS、不需要 webhook URL、不需要防火牆設定——gateway 主動發起到 Feishu Open Platform 的 outbound WebSocket 連線。

部署內容

服務	用途	公開
openab	執行 Kiro CLI 的 OAB agent	否
openab-gateway	Feishu Long Connection ↔ OAB WebSocket 橋接	否

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

設定步驟

1. 建立 Feishu / Lark App

1. 至 open.feishu.cn（中國）或 open.larksuite.com（國際）→ 建立自建應用。
2. 啟用 機器人（Bot） 能力。
3. 事件訂閱 → 選 長連線 / Long Connection（WebSocket）模式 → 訂閱 im.message.receive_v1 事件。
4. 權限與作用域 → 授予：
   • im:message
   • im:message:send_as_bot
   • contact:user.base:readonly
5. 憑證與基本資訊 → 複製 App ID → 貼到 Feishu/Lark App ID。
6. 同一頁 → 複製 App Secret → 貼到 Feishu/Lark App Secret。
7. 若使用 Lark 國際版，Feishu/Lark Domain 填 lark（否則保持 feishu）。
8. 發布應用版本（Feishu / Lark 需要先發布版本，bot 才能被使用）。

2. （選填）取得 Kiro API Key

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

3. 部署

點擊部署。不會分配公開網域——兩個服務都在內部網路執行。

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

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

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

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

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

5. 測試

在 Feishu / Lark 內開啟 bot 並發送私訊。Gateway 透過 outbound Long Connection 收到 → 透過 WebSocket 轉發給 OAB → OAB 回覆透過 Gateway 送出。

群組對話：把 bot 邀請進群，然後 @<你的 bot> hello。預設 Feishu 群組需要 @mention（FEISHU_REQUIRE_MENTION=true），私訊不需要。

自訂設定

• /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 → 服務 → 設定修改映像標籤。
• 進階 env（設在 openab-gateway）：FEISHU_ALLOWED_GROUPS / FEISHU_ALLOWED_USERS（CSV 限制特定群組或使用者）、FEISHU_REQUIRE_MENTION=false（群組免 @ 自動回應）、FEISHU_ALLOW_BOTS=mentions|all（允許其他 bot @ 本 bot）。

想換不同的 agent 後端？

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

想用其他通訊平台？

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

連結

• OpenAB GitHub
• Feishu/Lark 設定指南
• 獨立 OpenAB Gateway 模板