OpenClaw 2.7.9 连接飞书完整实操教程本文基于飞书开放平台后台操作逻辑、OpenClaw Windows 2.7.9 客户端渠道配置逻辑整理采用企业自建应用搭配长连接接收事件的对接方案整套配置仅需要 App ID、App Secret 两组参数即可完成两端打通。核心要点梳理OpenClaw 飞书渠道配置仅录入 App ID、App Secret 两项参数飞书后台完整配置分为五大核心环节创建自建应用、开启机器人能力、配置长连接事件订阅、批量开通应用权限、发布应用版本统一选用长连接接收事件模式无需额外部署公网服务不用手动填写回调地址。前置环境准备本地已下载安装 OpenClaw 2.7.9 Windows 客户端安装包体积 45.8MB下载地址Windows 版本 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 适配长连接交互模式无需公网回调地址选中「使用长连接接收事件」选项点击保存按钮完成当前设置。步骤 6新增消息接收事件项订阅方式保存完毕后在「已添加事件」区域右侧点击「添加事件」按钮。步骤 7添加机器人收消息核心事件弹出的事件选择窗口内搜索关键词 “接收”勾选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后续 OpenClaw 客户端配置仅需这两项内容。步骤 19OpenClaw 客户端飞书渠道配置切换至本地 OpenClaw 2.7.9 Windows 客户端点击页面右上角设置进入聊天配置板块找到 Feishu/Lark飞书配置卡片将上一步复制的 App ID、App Secret 分别填入对应输入框。步骤 20启用渠道并保存配置确认飞书渠道右侧启用开关处于打开状态点击右上角保存渠道配置按钮保存完成即代表飞书渠道配置完毕。接入完成自检清单配置全部操作结束后可对照以下条目逐项核对避免配置遗漏飞书自建应用已成功添加机器人应用能力事件与回调模块订阅方式选择长连接接收事件已添加im.message.receive_v1消息接收事件事件配套全部依赖权限状态均为已开通权限管理页面已导入完整权限 JSON 或逐项开通所需权限应用新版本已保存并完成发布App ID、App Secret 参数准确录入 OpenClaw 客户端OpenClaw 客户端内已点击保存渠道配置。常见问题排查方案1. 参数填写完成飞书机器人无交互响应优先按顺序检查以下配置项飞书应用版本是否发布成功事件订阅是否添加im.message.receive_v1事件订阅方式是否为长连接接收事件OpenClaw 保存渠道配置后可尝试重启 Gateway 服务复制 App Secret 时是否附带多余空格或使用旧版本凭证。2. 整套流程无需填写公网回调地址原因本次对接方案采用飞书官方支持的长连接交互模式基于 OpenClaw 2.7.9 客户端适配逻辑仅录入 App ID、App Secret 即可完成消息交互不需要手动配置 Webhook 回调地址。3. 权限是否必须完整导入 JSON仅实现机器人收发消息基础交互时可仅开通事件弹窗提示的基础权限若后续需要搭配 OpenClaw 使用文档、云空间、多维表格、知识库等拓展功能建议直接导入文中完整权限 JSON避免后续反复补充权限。参考访问地址飞书开放平台开发者后台https://open.feishu.cn/app