OpenAB WeCom Bundle

一鍵部署的 OpenAB WeCom（企業微信）bot — bot agent 與 callback gateway 打包在一起，只需填入 5 個 WeCom 憑證，並把 callback URL 貼進 WeCom 管理後台一次。

限制：WeCom 自建應用 callback 只能收**單聊（DM）**訊息，不支援群組（群組需要 appchat / WS bot API，目前 gateway 還沒接）。DM 流程完全沒問題。

部署內容

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

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

設定順序有講究

不像 Telegram（自動註冊）或 LINE（隨時貼 URL），WeCom 在你按管理後台「保存」時會立刻打 gateway 驗證——所以必須先把 Token + EncodingAESKey 在 gateway 設好、服務跑起來，再去 WeCom 按保存。

建議順序：在 WeCom 準備好值（先不要按保存）→ 用同樣的值部署 bundle → 回 WeCom 按保存。

設定步驟

1. 在 WeCom 建立自建應用

需要 WeCom（企業微信）企業帳號 + 管理員權限。

1. 至 WeCom 管理後台 → 應用管理 → 自建 → 創建應用 → 填名稱 / icon / 可見範圍。
2. 新應用詳情頁複製：
   • AgentId → 貼到 應用 AgentId
   • Secret → 點「查看」、用 WeCom 手機 app 驗證 → 複製 → 貼到 應用 Secret
3. 點 我的企業（頂部選單）→ 企業信息 → 複製 企業 ID → 貼到 企業 ID。

2. 準備 Token + EncodingAESKey（先不要按保存）

應用詳情頁 → 接收消息 → 设置API接收：

1. Token → 點「隨機獲取」或自訂 → 貼到 回調 Token。
2. EncodingAESKey → 點「隨機獲取」→ 貼到 EncodingAESKey。
3. URL 欄位先留空——步驟 5 才填。
4. 不要按「保存」——WeCom 會立刻驗證 URL，這時候 gateway 還沒部署會失敗。

3. （選填）取得 Kiro API Key

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

4. 部署

確認 5 個 WeCom 值都已填好 → 點部署。系統會自動分配公開 HTTPS 網域給 gateway 服務。

5. 回 WeCom 填 Callback URL 並保存

1. 打開 openab-gateway 服務頁面 → 查自動分配的網域。
2. 完整 callback URL 為：https://<你的_GATEWAY_網域>/webhook/wecom
3. 回 WeCom 管理後台 → 接收消息 → 设置API接收 → URL → 貼上 URL。
4. 點 保存 — WeCom 會發 verification GET 給 gateway，如果你的 Token + EncodingAESKey 兩邊一致，保存成功。若驗證失敗，回頭核對兩邊的 Token 和 EncodingAESKey 是否完全一致。

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

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

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

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

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

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

7. 測試

在 WeCom 開啟 bot（在你應用的可見範圍內）發 DM。Gateway 解密 callback → 透過 WebSocket 轉給 OAB → OAB 回覆透過 gateway → WeCom message API 送回。

記得：只有單聊會觸發 bot，群組不支援。

自訂設定

• /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 → 服務 → 設定修改映像標籤。

為什麼 callback 沒有自動註冊？

WeCom 自建應用的 callback URL 是在管理後台手動設定，沒有 API。Bundle 在 gateway 的 Instructions 區預填了完整 URL 方便複製，只需要做一次。

想換不同的 agent 後端？

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

想用其他通訊平台？

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

連結

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