OpenClaw v2.7.9 对接飞书机器人图文实操教程长连接模式无需公网回调本篇教程结合飞书开放平台后台界面、配套操作截图与 Windows 端 OpenClaw v2.7.9 渠道配置逻辑整理而成整套链路采用企业自建机器人应用方案。整体操作逻辑为先在飞书开发者后台完成应用搭建、权限与事件配置再将应用凭证录入 OpenClaw 即可完成双向联动。核心配置要点提前说明OpenClaw 飞书渠道仅需填入 App ID、App Secret 两组凭证即可完成绑定飞书平台优先选用长连接事件接收模式。想要实现消息互通必须完整走完应用创建、机器人能力开启、事件订阅配置、接口权限开通、应用版本发布五大环节。一、部署前置条件本地已完整安装 OpenClaw v2.7.9 整合包程序正常启动且 Gateway 服务保持在线Windows 部署包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CmacOS 部署包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 确认批量导入权限完整粘贴代码后点击下一步确认新增全部权限条目。步骤 13 统一数据访问范围部分权限会弹出数据范围配置窗口全部保持「与应用的可用范围一致」默认选项点击确认保存。步骤 14 进入版本发布管理页面权限、事件全部配置完毕后必须发布新版本所有设置才会生效。页面顶部存在创建版本按钮可直接点击无快捷入口则通过左侧版本管理与发布进入。步骤 15 填写版本基础信息自定义全新版本编号如 1.0.0移动端、桌面端默认能力统一选择机器人更新说明可填写事件订阅优化、全量权限开通。步骤 16 保存当前版本配置滑动页面至底部点击保存按钮留存版本信息。步骤 17 提交版本发布审核保存完成后点击确认发布。个人飞书空间一般无需人工审核直接生效企业飞书组织需要管理员审批通过后配置才能正常使用。步骤 18 复制应用两组核心凭证左侧切换至凭证与基础信息页面复制 App ID、App Secret 两组密钥妥善留存后续填入 OpenClaw 渠道面板。步骤 19 OpenClaw 端打开飞书配置面板启动 OpenClaw v2.7.9点击页面右上角设置按钮切换至聊天配置分类找到 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 建立持续连接完成消息收发仅依靠 App ID、App Secret 完成身份鉴权无需部署公网服务、填写 Webhook 地址。问题 3 是否必须导入全套权限 JSON仅实现基础收发对话指令可仅开通事件所需最小权限如果后续需要联动多维表格、在线文档、云盘、知识库等拓展功能建议直接导入完整权限配置避免反复新增权限。参考访问地址飞书开放平台开发者后台https://open.feishu.cn/app