logo
icon

OpenAB Feishu/Lark Bundle

一键部署的 Feishu / Lark Bot,集成 OpenAB + Kiro。同时部署 OAB agent 与 Feishu gateway,只需填入 App ID 与 App Secret 即可使用。默认使用 WebSocket 模式(无需 public webhook URL),无需另外部署 gateway、无需手动修改 config.toml。 来源:https://github.com/openabdev/openab

template cover
部署次数0
发布者zeaburZeabur
创建于2026-05-21
最低配置2 核心4 GB
推荐配置4 核心8 GB
标签
AIDeveloper ToolsFeishuLark

OpenAB Feishu/Lark Bundle

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

不需要 public HTTPS、不需要 webhook URL、不需要防火墙设置——gateway 主动发起到 Feishu Open Platform 的 outbound WebSocket 连线。

部署内容

服务用途公开
openab运行 Kiro CLI 的 OAB agent
openab-gatewayFeishu Long Connection ↔ OAB WebSocket 桥接

设置步骤

1. 创建 Feishu / Lark App

  1. open.feishu.cn(中国)或 open.larksuite.com(国际)→ 创建自建应用
  2. 启用 机器人(Bot) 能力。
  3. 事件订阅 → 选 长连接 / Long Connection(WebSocket)模式 → 订阅 im.message.receive_v1 事件。
  4. 权限与作用域 → 授予 im:messageim:message:send_as_botcontact:user.base:readonly
  5. 凭证与基本信息 → 复制 App IDApp Secret → 分别粘贴到 Feishu/Lark App IDFeishu/Lark App Secret
  6. 国际版 Lark 把 Feishu/Lark Domain 设为 lark(否则保持 feishu)。
  7. 发布应用版本(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),私信不需要。

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

链接