octop v0.9.24通过原生connector框架与oauth+mcp网关直连飞书,需企业认证、自建应用上线、开通指定权限及事件订阅;配置app id/secret、验证token等参数后,经管理员oauth授权并设置群权限,即可实现双向事件通信与用户身份映射。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.24 连接飞书通道不依赖 OpenClaw 的插件机制,而是通过其原生的 Connector 框架和 OAuth + MCP 网关 实现。它不走传统机器人 Webhook 或应用 Bot 授权流,而是以“受信客户端”身份接入飞书开放平台,支持双向事件订阅(如消息、卡片交互、用户变更)和更细粒度的权限控制。
确认飞书侧前提条件
Octop 要求飞书端启用标准企业级应用能力:
- 已在飞书开放平台完成企业认证(非个人版)
- 创建的是「企业自建应用」,不是「自定义机器人」或「小程序」
- 应用已发布上线(开发态不可用于生产通道)
- 在「权限管理」中至少开通:
im:message:send_as_bot、im:message:readonly、contact:user.employee_id:readonly、cardkit:card:read/write - 在「事件订阅」中启用:
message_received_v1和interactive_message_v1(用于按钮/卡片回调)
配置 Octop 的飞书 Connector
进入 Octop 管理后台(默认 http://localhost:8080/admin),导航至 Connectors → Add New → Feishu (Lark):
- 填写「App ID」和「App Secret」——来自飞书应用「凭证与基础信息」页
- 「Verification Token」和「Encrypt Key」需手动从飞书「事件订阅」设置中复制粘贴(二者必须严格匹配)
- 「Event URL」由 Octop 自动生成(形如
https://your-octop-domain.com/api/feishu/event),需填入飞书「事件订阅 URL」栏并完成验证 - 勾选「Enable user identity mapping」可同步飞书用户 ID 到 Octop 内部账号体系(推荐开启)
授权与上下文绑定
首次启用时,Octop 会生成一个 OAuth 授权链接。管理员需用飞书主管理员账号点击授权,完成以下动作:
- 授予 Octop 对当前租户(tenant)的读写权限
- 选择授权范围:支持按部门/角色批量授权,也可限制为指定群组(如「AI 助手测试组」)
- 授权后,Octop 自动拉取成员列表,并为每位用户建立独立记忆空间(基于
harness-memory) - 若需在特定群聊启用 AI 服务,须在飞书端将 Octop 应用添加为该群「群管理员」或「群机器人」(非 Webhook Bot)
验证与调试
连接成功后,Octop 后台会显示「Feishu Status: Connected」绿色标识。建议立即执行三项验证:
- 在飞书中 @Octop 发送「/help」,应返回内置命令列表(非静态文本,而是动态渲染的卡片)
- 发送「/status」查看当前模型负载、上下文长度、最近 5 条执行日志
- 点击任意卡片中的「Retry」按钮,验证交互回调链路是否完整(含签名验签)











