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）

设置顺序有讲究

不像 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。免费方案跳过此步骤。

4. 部署

确认 5 个 WeCom 值都已填好 → 点部署。系统会自动分配公开 HTTPS 域名给 gateway 服务。

5. 回 WeCom 填 Callback URL 并保存

1. 打开 openab-gateway 服务页面 → 查自动分配的域名。
2. 完整 callback URL：https://<你的_GATEWAY_域名>/webhook/wecom
3. 回 WeCom 管理后台 → 接收消息 → 设置API接收 → URL → 粘贴。
4. 点 保存 — WeCom 会发 verification GET 给 gateway，如果两边 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

7. 测试

在 WeCom 打开 bot（在你应用的可见范围内）发 DM。Gateway 解密 callback → 通过 WebSocket 转发给 OAB → OAB 回复通过 gateway → WeCom message API 发出。

记得：只有单聊会触发 bot，群聊不支持。

想换不同的 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 设置指南