OpenClaw 2.7.9 对接飞书机器人长连接模式完整配置指南本文结合飞书开放平台操作界面、配套截图素材以及 Windows 端 OpenClaw 2.7.9 内置飞书渠道配置逻辑整理而成。整套流程采用「飞书开放平台搭建企业自建应用提取 App ID 与 App Secret 填入 OpenClaw」的接入方案。核心接入要点OpenClaw 飞书渠道仅需录入 App ID、App Secret 两组凭证即可完成基础配置飞书平台侧推荐采用长连接方式接收消息事件整套部署流程分为五大关键环节应用创建、机器人能力开启、事件订阅配置、权限批量开通、应用版本发布。前置准备本地设备已部署 OpenClaw 2.7.9 Windows 客户端程序可正常启动运行Windows 安装包地址https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CMac 系统安装包地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C安装包大小 45.8MB持有飞书开放平台登录账号可正常访问开发者后台拥有可使用的飞书企业或组织空间用于创建自建应用企业类型账号发布应用版本时需要对应企业管理员完成审核操作分步完整操作流程步骤 1访问飞书开放平台新建企业自建应用打开飞书开放平台地址https://open.feishu.cn/app 点击页面右上角「开发者后台」选择创建企业自建应用。步骤 2填写应用基础信息自定义机器人应用名称补充简短功能描述选用平台默认头像或上传自定义图片确认信息后点击创建。步骤 3为应用开启机器人功能模块进入应用后台点击左侧「添加应用能力」在能力列表找到机器人选项点击添加完成功能开通。步骤 4进入事件与回调配置页面左侧导航栏选择「事件与回调」在事件配置板块点击订阅方式右侧编辑按钮开启修改权限。步骤 5切换为长连接事件接收模式并保存配置时不要选择「将事件发送至开发者服务器」。当前 OpenClaw 对接方案无需配置公网回调地址直接选中「使用长连接接收事件」保存设置。步骤 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 2.7.9 配置飞书渠道打开 OpenClaw 2.7.9点击右上角设置进入聊天配置板块找到 Feishu/Lark 飞书配置卡片将复制的 App ID、App Secret 分别填入对应输入框。步骤 20启用渠道并保存全部配置开启飞书渠道右侧开关点击右上角保存渠道配置保存后飞书渠道即完成全部部署。部署完成自检核对清单飞书自建应用已添加机器人能力事件与回调订阅方式设置为长连接接收事件成功添加 im.message.receive_v1 接收消息事件事件配套权限全部显示已开通状态权限管理页面完整导入全套权限 JSON应用版本已保存并提交发布App ID、App Secret 准确填写至 OpenClaw 2.7.9 飞书配置栏OpenClaw 内执行保存渠道配置操作高频问题排查方案1. 参数填写完成但飞书机器人无任何响应按照以下顺序逐项排查飞书应用是否成功发布完成未审核通过的版本无法生效事件订阅是否选定 im.message.receive_v1事件接收模式是否为长连接接收事件未选错 webhook 模式OpenClaw 保存渠道配置后可重启 Gateway 网关重试复制 App Secret 时是否带入多余空格或使用过期密钥2. 本方案无需填写公网回调地址的原因整套对接流程采用飞书原生支持的长连接通信模式当前 OpenClaw 2.7.9 飞书渠道仅依靠 App ID、App Secret 建立通信链路无需手动部署公网 Webhook 地址。3. 是否必须导入全套权限 JSON仅实现基础收发消息功能可仅开通事件弹窗自带的基础权限如果需要借助 OpenClaw 操作飞书文档、多维表格、云空间、知识库等拓展功能建议直接导入完整权限 JSON避免后续权限缺失。参考链接飞书开放平台开发者后台企业飞书空间接入 OpenClaw 2.7.9 机器人避坑教程