OpenClaw 2.7.9 对接飞书机器人完整图文实操教程文档概述本文基于飞书开放平台后台界面、配套截图素材以及 OpenClaw Windows 客户端现有飞书渠道配置逻辑整理编写采用企业自建应用 长连接接收事件接入方案整套流程仅需填写 App ID、App Secret 两项参数即可完成对接。 完整落地流程分为五大核心环节应用创建、机器人能力配置、事件订阅、权限批量开通、应用版本发布最后在 OpenClaw 客户端录入凭证启用飞书通信渠道。前置环境要求本地设备已部署 OpenClaw 2.7.9 Windows 客户端程序可正常启动运行安装包大小 45.8MBWindows 客户端下载地址https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统客户端下载地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C持有飞书开发者账号能够正常登录飞书开放平台开发者后台拥有可用的飞书企业 / 组织空间用于创建机器人应用企业类型飞书空间应用版本提交发布后需要企业管理员完成审核流程完整分步操作流程步骤 1访问飞书开放平台创建企业自建应用访问飞书开放平台官方地址https://open.feishu.cn/app页面右上角点击「开发者后台」完成账号登录在应用创建分类中选择「创建企业自建应用」步骤 2完善机器人应用基础信息自定义设置应用名称、功能介绍文字可选用系统默认头像或上传自定义图标信息填写完成后点击「创建」按钮保存应用。步骤 3为应用新增机器人运行能力应用左侧导航栏选择「添加应用能力」在能力列表检索「机器人」选项选中后点击添加步骤 4进入事件与回调配置页面左侧菜单栏打开「事件与回调」板块找到事件订阅方式一栏点击右侧编辑按钮进入配置界面。步骤 5选定长连接接收事件核心关键配置订阅方式禁止选择「将事件发送至开发者服务器」统一勾选「使用长连接接收事件」并保存设置。 该方案无需准备公网服务器与回调地址适配本地运行的 OpenClaw 2.7.9 客户端架构。步骤 6新增消息监听事件条目保存订阅方式配置后在「已添加事件」区域点击「添加事件」按钮。步骤 7添加消息接收核心事件 im.message.receive_v1在弹出的事件选择窗口搜索关键词「接收」勾选事件im.message.receive_v1接收消息确认添加。 该事件是飞书机器人接收对话消息的核心配置项缺失后 OpenClaw 无法捕获飞书内发给机器人的消息内容。步骤 8一键开通事件配套基础权限系统弹出权限推荐开通弹窗时直接点击「确认开通权限」批量授予事件运行所需基础权限。步骤 9校验事件关联权限全部开通状态展开已添加事件下方的权限明细列表全部权限状态必须显示为「已开通」若存在未开通权限点击对应权限名称手动完成授权。步骤 10打开权限批量导入功能左侧导航切换至「权限管理」页面点击页面内「批量导入 / 导出权限」功能按钮。步骤 11粘贴完整权限 JSON 批量授权清空导入输入框内原有默认文本内容复制下方完整权限 JSON 字符串完整粘贴至输入框内json{ scopes: { tenant: [ aily:message:read, aily:message:write, base:app:copy, base:app:create, base:app:read, base:app:update, base:collaborator:create, base:collaborator:delete, base:collaborator:read, base:dashboard:copy, base:dashboard:read, base:field:create, base:field:delete, base:field:read, base:field:update, base:form:read, base:form:update, base:record:create, base:record:delete, base:record:read, base:record:retrieve, base:record:update, base:role:create, base:role:delete, base:role:read, base:role:update, base:table:create, base:table:delete, base:table:read, base:table:update, base:view:read, base:view:write_only, bitable:app, bitable:app:readonly, board:whiteboard:node:create, board:whiteboard:node:delete, board:whiteboard:node:read, board:whiteboard:node:update, cardkit:card:write, contact:contact.base:readonly, contact:user.base:readonly, contact:user.employee_id:readonly, contact:user.employee_number:read, contact:user.id:readonly, docs:doc, docs:doc:readonly, docs:document.comment:create, docs:document.comment:read, docs:document.comment:update, docs:document.comment:write_only, docs:document.content:read, docs:document.media:download, docs:document.media:upload, docs:document.subscription, docs:document.subscription:read, docs:document:copy, docs:document:export, docs:document:import, docs:event.document_deleted:read, docs:event.document_edited:read, docs:event.document_opened:read, docs:event:subscribe, docs:permission.member, docs:permission.member:auth, docs:permission.member:create, docs:permission.member:delete, docs:permission.member:readonly, docs:permission.member:retrieve, docs:permission.member:transfer, docs:permission.member:update, docs:permission.setting, docs:permission.setting:read, docs:permission.setting:readonly, docs:permission.setting:write_only, docx:document, docx:document.block:convert, docx:document:create, docx:document:readonly, drive:drive, drive:drive.metadata:readonly, drive:drive.search:readonly, drive:drive:readonly, drive:drive:version, drive:drive:version:readonly, drive:export:readonly, drive:file, drive:file.like:readonly, drive:file.meta.sec_label.read_only, drive:file:download, drive:file:readonly, drive:file:upload, drive:file:view_record:readonly, event:ip_list, im:app_feed_card:write, im:chat, im:chat.members:read, im:chat:read, im:message, im:message.group_msg, im:message:send_as_bot, im:message:readonly, im:message:update, sheets:spreadsheet, sheets:spreadsheet:create, sheets:spreadsheet:read, space:folder:create, wiki:node:create, wiki:node:read, wiki:node:update, wiki:space:read ], user: [] } }步骤 12确认导入新增权限确认 JSON 文本完整粘贴无误后点击「下一步确认新增权限」完成批量导入。步骤 13数据范围保持默认配置部分权限会弹出数据访问范围确认窗口全部保持默认选项「与应用的可用范围一致」点击确认即可。步骤 14进入版本管理发布页面权限与事件全部配置完成后需要创建并发布应用版本飞书平台侧所有配置才能正式生效。 若页面顶部存在「创建版本」快捷按钮可直接点击无快捷按钮则从左侧「版本管理与发布」入口进入。步骤 15填写版本基础信息版本信息填写规范版本号填写全新数值推荐 1.0.0、1.0.1 等格式移动端、桌面端默认能力统一选择「机器人」更新说明可简洁填写示例更新事件订阅完善应用权限步骤 16保存当前版本配置滑动页面至底部点击「保存」按钮存储当前版本信息。步骤 17提交版本发布保存完成后点击「确认发布」。个人飞书空间提交后可直接上线企业类型飞书空间提交后等待企业管理员审核通过方可生效。步骤 18复制应用凭证 App ID 与 App Secret左侧菜单栏切换至「凭证与基础信息」页面复制两组关键参数App IDApp Secret OpenClaw 2.7.9 客户端飞书渠道仅需这两组凭证即可完成配置。 配套截图18.png步骤 19打开 OpenClaw 飞书渠道配置界面启动本地 OpenClaw 2.7.9 Windows 客户端点击页面右上角「设置」进入「聊天配置」板块找到 Feishu/Lark飞书配置卡片将上一步复制的 App ID、App Secret 分别填入对应输入框。步骤 20启用渠道并保存全部配置确认飞书渠道右侧开关处于开启状态点击右上角「保存渠道配置」。保存完成后OpenClaw 客户端内飞书渠道即为配置完成状态。接入完成自检清单配置全部结束后按以下条目逐项核对避免配置遗漏飞书应用已成功添加「机器人」应用能力事件与回调订阅方式设置为「长连接接收事件」已正常添加im.message.receive_v1消息接收事件事件对应的全部依赖权限状态均为「已开通」权限管理页面已导入完整权限 JSON无缺失权限项应用版本已保存并完成发布流程App ID、App Secret 无多余空格、复制无误已填入 OpenClaw 客户端OpenClaw 客户端内飞书渠道配置执行保存操作常见问题排查方案1. OpenClaw 录入凭证后飞书机器人无任何交互反馈按优先级依次检查以下内容飞书应用版本是否发布成功企业账号确认管理员审核已通过事件订阅是否添加im.message.receive_v1未选错其他事件事件订阅方式是否为长连接模式未切换至开发者服务器回调OpenClaw 保存渠道配置后尝试重启 Gateway 服务App Secret 复制时存在多余空格或使用旧版本凭证2. 整套流程无需填写公网回调地址的原因本次接入方案采用飞书官方支持的长连接交互模式适配 OpenClaw 2.7.9 本地客户端运行架构仅依靠 App ID、App Secret 完成鉴权通信无需手动配置 Webhook 回调链接。3. 权限是否必须完整导入 JSON 配置仅实现机器人收发消息的基础交互可仅开通事件弹窗推荐的基础权限若后续需要搭配多维表格、文档、云空间、知识库等拓展功能建议直接导入完整权限 JSON避免后续重复补充授权。参考访问链接飞书开放平台开发者后台https://open.feishu.cn/app