OpenClaw安装飞书插件
OpenClaw飞书插件集成指南 本文详细介绍了如何将OpenClaw智能助手集成到飞书平台。主要内容包括:1)在飞书开放平台创建企业自建应用并配置机器人能力;2)设置必要的权限和事件订阅;3)安装配置OpenClaw飞书插件;4)完成设备配对流程;5)功能验证方法。同时提供了常见问题的解决方案,如权限缺失和插件重复问题。通过该集成,用户可在飞书群聊和单聊中与AI助手交互,实现智能问答、文档协作等
OpenClaw飞书插件集成
OpenClaw接入飞书后,可实现以下深度集成功能:
- 群聊@响应功能
- 支持智能识别群聊中@OpenClaw的消息
- 可配置多种响应模式(即时回复/延迟处理)
- 示例:当用户在飞书群中@OpenClaw并提问"本周会议纪要在哪里?",系统会自动检索并回复相关文档链接
- 单聊交互功能
- 提供7×24小时一对一对话服务
- 支持富文本消息(图文/表格/文件)交互
- 应用场景:员工可通过私聊查询考勤、申请审批等HR事务
- 文档协作功能
- 实时同步飞书文档编辑状态
- 支持版本对比和修改建议
- 典型用例:多人协作时,OpenClaw可自动检测文档冲突并给出合并建议
- 扩展功能
- 会议管理:自动同步会议日程,智能生成会议纪要
- 任务追踪:根据聊天内容自动创建并分配任务
- 数据看板:整合多源数据生成可视化报表
一、飞书应用创建与配置
-
访问飞书开放平台(https://open.feishu.cn/app),登录企业飞书账号;
-
创建企业自建应用:
-
点击“创建企业自建应用”,输入应用名称(如“OpenClaw AI助手”),上传图标,点击“创建”;


-
-
添加机器人能力:
- 左侧导航栏点击“添加应用能力”,选择“机器人”→“添加”;

-
权限配置:
-
左侧导航栏单击 权限管理 页面,点击批量导入/导出权限 按钮,粘贴以下 JSON 配置,单击下一步,确认新增权限,单击申请开通。其他选项直接默认,然后点击确认完成权限配置。(权限开通如果少了会影响后续调用,这里直接使用阿里云提供的权限开通模板)
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"] } }开通之后的样子:

-
-
获取应用凭证:
-
点击“凭证与基础信息”,复制“App ID”和“App Secret”,保存备用;

-
-
发布应用:
-
点击“版本管理与发布”→“创建版本”,填写版本号(如1.0.0),选择“部分成员”测试,无需审核即可生效。

-
二、OpenClaw飞书插件配置
安装步骤:
# 1. 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu
# 2. 配置飞书App ID(替换为飞书平台获取的ID)
openclaw config set channels.feishu.appId "你的飞书App ID"
# 3. 配置飞书App Secret(替换为飞书平台获取的Secret)
openclaw config set channels.feishu.appSecret "你的飞书App Secret"
# 4. 启用飞书通道
openclaw config set channels.feishu.enabled true
# 5. 配置连接方式为WebSocket
openclaw config set channels.feishu.connectionMode websocket
# 6. 重启Gateway生效
openclaw gateway restart
三、配置飞书插件事件回调
-
配置事件订阅
-
在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存
-
在事件配置页面,单击添加事件,搜索事件
im.message.receive_v1(接收消息),单击确认添加。
-
-
发布应用
- 点击“版本管理与发布”→“创建版本”,填写版本号(如1.0.1),选择“部分成员”测试,无需审核即可生效。
注意:在没有与OpenClaw配置连接之前是无法配置事件回调的
四、设备配对
-
打开飞书APP,进入“工作台”,找到已发布的“OpenClaw AI助手”;

-
发送任意一条消息,比如“你好”,机器人会回复一个配对码,在服务器控制台输入
openclaw pairing approve feishu 配对码完成配对,也可以放到OpenClaw的在WebUI页面中让其执行;
五、功能验证
- 打开飞书APP,进入“工作台”,找到已发布的“OpenClaw AI助手”;
- 发送“你好”,若收到AI正确回复,说明接入成功;
- 群聊使用:在飞书群中@机器人,发送指令(如“总结本次会议要点”),机器人将自动响应。
六、问题
(一)飞书权限缺失
配置完成后与AI交互可能会出现权限缺失问题contact:contact.base:readonly,重新登陆飞书控制台,在权限管理中重新开通对应缺失权限即可
(二)飞书插件重复
新版的OpenClaw全局预装了飞书插件,后续不管是升级OpenClaw版本还是自己下载飞书插件都会提示重复问题。虽然不影响实际使用,但是每次执行命令都会出现警告
解决方式:找到飞书插件在OpenClaw中位置,通常为/home/你的用户名称/.openclaw/extensions,将这个目录下的飞书文件夹直接删除,让OpenClaw继续使用全局配置的飞书组件,最后重启OpenClaw网关
更多推荐



所有评论(0)