【干货分享】详解 OpenClaw 飞书对接步骤，事件配置与权限开通干货（包含安装包）

OpenClaw v2.7.9 接入飞书配置教程依托长连接实现机器人消息互通本文详述 OpenClaw 对接飞书的完整实操方案整体采用飞书长连接接收事件的接入逻辑无需配置公网回调域名仅需在飞书开放平台创建自建应用拿到 App ID、App Secret 填入 OpenClaw 即可完成联动。安卓安装包下载地址https://xiake.yun/api/download/package/17?promoCodeIV4E9B04A80C苹果的安装包下载地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C安装包体积 45.8MB建议使用浏览器自带下载工具下载减少文件损坏。下载完成核对压缩包文件名无误后再进行解压。一、前期部署准备本地已部署 OpenClaw v2.7.9软件 Gateway 保持在线状态拥有飞书开发者平台账号具备企业空间或组织资源企业类型账号发布应用版本时需要对应管理员完成审核。 飞书开发者后台地址https://open.feishu.cn/app二、飞书开放平台应用配置步骤 1新建企业自建应用登录开发者后台选择创建企业自建应用可选用空白模板或智能体快捷模板。步骤 2完善应用基础资料自定义应用名称、简介内容按需上传图标素材图标格式支持 JPG/PNG/SVG/BMP文件体积控制在 2MB 以内尺寸不小于 240*240px信息填写完毕点击创建。步骤 3添加机器人应用能力进入应用管理页在应用能力栏目找到机器人选项完成能力添加是实现消息交互的基础。步骤 4事件与回调配置打开左侧事件与回调菜单修改订阅方式选定使用长连接接收事件不选择服务器回调模式并保存设置。步骤 5添加消息接收事件在事件列表点击添加事件检索并勾选im.message.receive_v1接收消息v2.0该事件是机器人收发消息的核心配置项。步骤 6开通事件配套权限根据页面提示确认开通事件所需权限逐项核查权限状态未启用的权限手动补齐。步骤 7批量导入全套权限进入权限管理页面打开批量导入导出窗口清空原有内容粘贴文末完整权限 JSON 代码点击下一步确认新增权限权限的数据范围保持默认配置即可。步骤 8创建并发布应用版本进入版本管理栏目新建版本号示例 1.0.0移动端与桌面端默认能力选定机器人填写版本更新备注保存后提交发布。个人主体一般免审核直接上线企业主体需管理员审批。步骤 9提取应用密钥返回凭证与基础信息页面复制App ID、App Secret两组参数妥善留存。三、OpenClaw 软件端参数配置打开 OpenClaw v2.7.9进入设置 - 聊天配置找到 Feishu/Lark (飞书) 配置卡片将复制好的 App ID、App Secret 依次填入对应输入框开启渠道启用开关点击页面右上角保存渠道配置配置完成后在飞书内搜索机器人发送消息验证 AI 回复效果。 配置未生效时重启 Gateway 服务等待在线后再次测试。四、接入自检清单飞书应用已成功添加机器人能力版本完成发布上线事件订阅选用长连接模式已添加 im.message.receive_v1 事件全部配套权限正常开通完整权限 JSON 导入无误App ID 与 App Secret 无多余空格参数填写无误OpenClaw 飞书渠道保存配置Gateway 处于在线状态五、常见异常处理机器人发送消息无应答核查应用是否发布成功、事件订阅类型、密钥空格、网关在线状态必要时重启 Gateway无需填写公网地址本方案依托飞书长连接机制仅两项密钥即可完成对接权限选择建议仅基础回复可只开通事件必需权限需要多维表格、文档联动则导入全套权限。配套权限 JSONjson{ 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: [] } }安卓安装包下载地址https://xiake.yun/api/download/package/17?promoCodeIV4E9B04A80C苹果的安装包下载地址https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C安装包体积 45.8MB建议使用浏览器自带下载工具下载减少文件损坏。下载完成核对压缩包文件名无误后再进行解压。