OpenAB Feishu Bundle

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

部署内容

服务	用途	公开
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 确认对外连接已建立。

想换不同的 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 模板