飞书开放平台创建机器人对接 OpenClaw，事件订阅与权限导入手册（含安装包）

OpenClaw 连接飞书图文实操教程本文结合飞书开放平台后台界面、配套截图素材以及 OpenClaw v2.7.9 内置飞书渠道配置逻辑整理完整操作流程整体方案逻辑为先在飞书开放平台搭建企业自建应用再将应用生成的 App ID、App Secret 填入 OpenClaw 客户端完成联动。整体接入核心要点OpenClaw v2.7.9 飞书渠道仅需录入 App ID、App Secret 两项参数飞书应用侧推荐采用长连接模式接收推送事件整套部署需要完成应用创建、机器人能力添加、事件订阅配置、权限批量开通、版本发布五大核心环节。前置环境准备本地已部署 OpenClaw v2.7.9 Windows 客户端程序可正常启动运行登录飞书开放平台能够正常进入开发者后台页面持有可用飞书企业组织或团队空间企业类型账号发布应用版本时需要企业管理员完成审核流程。OpenClaw 整合资源包大小 45.8MBWindows 安装包下载地址https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CmacOS 安装包下载地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C完整图文操作步骤步骤 1访问飞书开放平台创建企业自建应用打开飞书开放平台地址https://open.feishu.cn/app 进入页面后点击右上角开发者后台入口选择创建企业自建应用。步骤 2完善应用基础信息自定义机器人应用名称补充简短功能描述可选用系统默认头像或上传自定义图标填写完成后点击创建按钮生成应用。步骤 3为应用新增机器人能力进入应用配置主页点击左侧添加应用能力在能力列表中找到机器人模块点击添加完成能力开通。步骤 4进入事件与回调配置页面左侧菜单栏选择事件与回调板块在事件配置区域找到订阅方式点击编辑按钮进入修改页面。步骤 5选定长连接接收事件并保存设置配置页面不要选择事件推送至开发者服务器选项OpenClaw v2.7.9 适配长连接接入方案无需额外配置公网回调地址选中使用长连接接收事件后保存配置。步骤 6新增事件订阅项保存订阅方式后在已添加事件区域点击添加事件按钮唤起事件选择弹窗。步骤 7勾选接收消息核心事件弹窗内检索关键词 “接收”勾选 im.message.receive_v1 接收消息事件并确认添加。该事件是机器人获取飞书对话消息的核心配置缺失后 OpenClaw 无法读取机器人收到的消息内容。步骤 8一键开通事件配套权限若页面弹出推荐开通权限提示框直接点击确认开通权限批量补齐事件运行所需基础权限。步骤 9校验事件依赖权限全部开通返回事件列表展开权限详情逐项核对权限状态均为已开通存在未激活权限时点击对应权限名称手动完成开通操作。步骤 10打开权限管理进入批量导入功能左侧切换至权限管理页面点击批量导入 / 导出权限功能入口。步骤 11粘贴完整权限 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 ID、App Secret 两组参数后续填入 OpenClaw 客户端。步骤 19OpenClaw v2.7.9 飞书渠道参数填写切换至 OpenClaw 客户端点击右上角设置进入聊天配置分类找到 Feishu/Lark飞书配置卡片将复制的 App ID、App Secret 分别填入对应输入框。步骤 20开启渠道开关并保存配置打开飞书渠道右侧启用开关点击右上角保存渠道配置完成 OpenClaw 与飞书应用的联动部署。接入完成自检核对清单飞书自建应用已成功添加机器人能力事件与回调订阅方式设置为长连接接收事件已添加 im.message.receive_v1 消息接收事件事件关联配套权限全部处于已开通状态权限管理页面已导入完整权限 JSON 或手动补齐所需权限应用新版本已保存并完成发布App ID、App Secret 参数完整无误填入 OpenClaw v2.7.9OpenClaw 内点击保存渠道配置渠道处于启用状态。高频问题排查方案1. 参数填写完成后飞书机器人无任何消息响应按顺序逐项排查 ① 飞书应用版本是否成功发布企业账号确认管理员审核已通过 ② 事件订阅是否添加 im.message.receive_v1 消息接收事件 ③ 事件订阅方式是否选定长连接接收事件 ④ OpenClaw 保存渠道配置后可尝试重启 Gateway 服务 ⑤ App Secret 复制时是否携带多余空格、换行或使用过期密钥。2. 整套流程无需填写公网回调地址的原因本次接入方案采用飞书官方长连接交互模式OpenClaw v2.7.9 内置连接通道仅依靠 App ID、App Secret 即可完成通信无需手动配置 Webhook 公网回调地址。3. 是否必须导入全套权限 JSON仅实现基础收发消息功能可只开通事件弹窗提示的必要权限若需要完整使用 OpenClaw 配套的多维表格、在线文档、云空间、知识库等联动能力建议直接导入完整权限 JSON避免后续权限缺失报错。配套参考链接飞书开放平台开发者后台https://open.feishu.cn/app