飞书开放平台自建应用对接 OpenClaw，凭证参数填写详解（含安装包）

OpenClaw v2.7.9 接入飞书机器人图文配置教程本文结合飞书开放平台页面、配套截图素材与 OpenClaw Windows 端渠道配置逻辑整理而成。整套接入逻辑为先在飞书开放平台创建企业自建应用完成事件、权限、版本配置后将应用凭证录入 OpenClaw 完成联动。核心说明OpenClaw 飞书渠道仅需录入 App ID、App Secret 两组参数飞书端推荐选用长连接接收事件模式整套流程包含应用创建、机器人能力开启、事件订阅、权限开通、版本发布五大核心环节缺一不可。前置准备条件设备已部署 OpenClaw v2.7.9 Windows 整合包程序可正常启动运行拥有可登录飞书开放平台的账号能够进入开发者后台具备可用飞书组织、企业空间用于承载自建机器人应用企业账号发布应用版本时需要企业管理员完成审核流程完整图文操作步骤步骤 1进入飞书开放平台创建企业自建应用打开飞书开放平台地址https://open.feishu.cn/app 页面右上角点击「开发者后台」在应用创建选项中选择「创建企业自建应用」。步骤 2完善应用基础信息填写机器人应用名称、补充功能描述选择系统默认头像或上传自定义图标信息填写完毕后点击创建。步骤 3为应用添加机器人核心能力进入应用功能面板点击左侧「添加应用能力」在能力列表找到「机器人」选项并完成添加。步骤 4进入事件与回调配置面板左侧菜单栏切换至「事件与回调」板块找到事件订阅区域点击编辑按钮调整接收模式。步骤 5选定长连接事件接收模式订阅方式处选择「使用长连接接收事件」切勿切换为服务器回调模式OpenClaw 本地部署方案无需公网地址设置完成保存配置。步骤 6新增消息接收事件保存订阅模式后在已添加事件区域点击「添加事件」按钮打开事件选择弹窗。步骤 7勾选接收消息核心事件弹窗内检索关键词 “接收”勾选im.message.receive_v1接收消息事件点击确认添加。该事件是机器人读取飞书消息的核心配置缺失将无法交互。步骤 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、1.0.1移动端、桌面端默认能力均选择机器人更新说明简单标注事件、权限更新内容。步骤 16保存当前版本配置页面滑动至底部点击保存按钮留存版本信息。步骤 17提交版本发布保存完成后点击确认发布个人飞书空间可直接完成发布企业账号需等待管理员审核通过后配置生效。步骤 18复制应用凭证参数左侧切换至「凭证与基础信息」页面完整复制 App ID、App Secret 两组参数后续填入 OpenClaw。步骤 19OpenClaw 飞书渠道参数填写切换至 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 服务复制凭证时无多余空格、未使用旧密钥2. 教程未要求填写公网回调地址原因整套联动方案采用飞书长连接通讯机制依托本地 WebSocket 通道交互无需部署公网服务器与回调域名仅录入两组应用凭证即可连通。3. 是否必须导入全套权限 JSON仅实现收发消息基础交互时开通事件弹窗自带权限即可如需联动飞书文档、多维表格、云盘、知识库等 OpenClaw 配套功能建议直接导入完整权限配置避免功能受限。资源获取地址Windows 版本https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80C苹果系统版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C