本文结合当前飞书开放平台页面、本目录里的截图素材以及 OpenClaw Windows 现有飞书配置方式整理。适用于“先在飞书开放平台创建企业自建应用再把 App ID 和 App Secret 填回 OpenClaw”的接入流程。一、前置准备条件在开始配置前需提前备好以下环境与账号条件确保流程顺利推进1、本地已安装OpenClaw Windows版本且软件可正常启动运行2、拥有飞书开放平台账号可正常登录并进入开发者后台3、具备可用的飞书组织或企业空间用于创建自建应用4、企业账号发布应用版本时大概率需要企业管理员审核通过二、详细图文配置步骤步骤1登录飞书开放平台创建企业自建应用打开飞书开放平台官方地址开发者后台 - 飞书开放平台进入官网页面后点击页面右上角「开发者后台」随后选择「创建企业自建应用」进入应用创建流程。步骤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、版本号自定义填写有效版本例如 1.0.0、1.0.12、端能力配置移动端、桌面端默认能力均保持为「机器人」3、更新说明简单备注即可示例更新事件订阅、完善应用权限配置步骤16保存应用版本下拉页面至底部点击「保存」完成新版本信息存储。步骤17发布应用版本版本保存成功后点击「确认发布」。个人账号通常可直接免审核发布企业账号需等待企业管理员审核通过后版本方可正式生效。步骤18获取应用核心凭证返回应用左侧菜单栏「凭证与基础信息」复制App ID和App Secret两个核心参数后续OpenClaw配置需使用这两个凭证。步骤19OpenClaw飞书渠道配置打开OpenClaw软件点击页面右上角「设置」进入「聊天配置」界面找到Feishu/Lark飞书配置卡片将上一步复制的App ID、App Secret分别对应填入输入框。步骤20启用并保存配置确认飞书渠道开关处于开启状态点击右上角「保存渠道配置」至此OpenClaw与飞书机器人的对接配置全部完成。三、接入完成自检清单配置完成后可通过以下清单逐一核验确保接入无异常1、飞书应用已成功添加「机器人」应用能力2、事件与回调配置为「长连接接收事件」模式3、已成功添加 im.message.receive_v1 接收消息事件4、事件关联的所有权限均为「已开通」状态5、权限管理已完整导入配置权限或逐项开通全部所需权限6、应用版本已成功保存并完成发布7、App ID、App Secret 已准确填入OpenClaw配置栏8、OpenClaw飞书渠道配置已点击保存并生效四、常见问题解决方案1、参数配置完成后飞书机器人无响应优先逐一排查以下核心问题核查飞书应用版本是否真正发布生效企业账号需确认审核通过确认订阅事件为标准的 im.message.receive_v1核对事件接收模式为「长连接接收事件」未选错配置保存OpenClaw渠道配置后可尝试重启Gateway服务检查App Secret是否存在多余空格、是否使用过期旧密钥2、本教程无需配置公网回调地址的原因本次接入采用飞书官方原生长连接模式是OpenClaw适配的专属接入方案。该方案仅依托App ID和App Secret即可完成消息接收与交互无需手动配置公网Webhook回调地址简化部署流程。3、权限是否需要全部导入若仅需实现「飞书发送消息、OpenClaw接收并自动回复」的基础功能可仅开通事件弹窗提示的必要权限。若后续需要使用文档、云空间、多维表格、知识库等拓展功能建议直接导入完整权限JSON避免后续权限缺失导致功能异常。五、官方参考地址飞书开放平台开发者后台开发者后台 - 飞书开放平台OpenClaw一键获取http://b.m6z.cn/hayK4
OpenClaw对接飞书机器人完整配置教程（长连接模式）
本文结合当前飞书开放平台页面、本目录里的截图素材以及 OpenClaw Windows 现有飞书配置方式整理。适用于“先在飞书开放平台创建企业自建应用再把 App ID 和 App Secret 填回 OpenClaw”的接入流程。一、前置准备条件在开始配置前需提前备好以下环境与账号条件确保流程顺利推进1、本地已安装OpenClaw Windows版本且软件可正常启动运行2、拥有飞书开放平台账号可正常登录并进入开发者后台3、具备可用的飞书组织或企业空间用于创建自建应用4、企业账号发布应用版本时大概率需要企业管理员审核通过二、详细图文配置步骤步骤1登录飞书开放平台创建企业自建应用打开飞书开放平台官方地址开发者后台 - 飞书开放平台进入官网页面后点击页面右上角「开发者后台」随后选择「创建企业自建应用」进入应用创建流程。步骤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、版本号自定义填写有效版本例如 1.0.0、1.0.12、端能力配置移动端、桌面端默认能力均保持为「机器人」3、更新说明简单备注即可示例更新事件订阅、完善应用权限配置步骤16保存应用版本下拉页面至底部点击「保存」完成新版本信息存储。步骤17发布应用版本版本保存成功后点击「确认发布」。个人账号通常可直接免审核发布企业账号需等待企业管理员审核通过后版本方可正式生效。步骤18获取应用核心凭证返回应用左侧菜单栏「凭证与基础信息」复制App ID和App Secret两个核心参数后续OpenClaw配置需使用这两个凭证。步骤19OpenClaw飞书渠道配置打开OpenClaw软件点击页面右上角「设置」进入「聊天配置」界面找到Feishu/Lark飞书配置卡片将上一步复制的App ID、App Secret分别对应填入输入框。步骤20启用并保存配置确认飞书渠道开关处于开启状态点击右上角「保存渠道配置」至此OpenClaw与飞书机器人的对接配置全部完成。三、接入完成自检清单配置完成后可通过以下清单逐一核验确保接入无异常1、飞书应用已成功添加「机器人」应用能力2、事件与回调配置为「长连接接收事件」模式3、已成功添加 im.message.receive_v1 接收消息事件4、事件关联的所有权限均为「已开通」状态5、权限管理已完整导入配置权限或逐项开通全部所需权限6、应用版本已成功保存并完成发布7、App ID、App Secret 已准确填入OpenClaw配置栏8、OpenClaw飞书渠道配置已点击保存并生效四、常见问题解决方案1、参数配置完成后飞书机器人无响应优先逐一排查以下核心问题核查飞书应用版本是否真正发布生效企业账号需确认审核通过确认订阅事件为标准的 im.message.receive_v1核对事件接收模式为「长连接接收事件」未选错配置保存OpenClaw渠道配置后可尝试重启Gateway服务检查App Secret是否存在多余空格、是否使用过期旧密钥2、本教程无需配置公网回调地址的原因本次接入采用飞书官方原生长连接模式是OpenClaw适配的专属接入方案。该方案仅依托App ID和App Secret即可完成消息接收与交互无需手动配置公网Webhook回调地址简化部署流程。3、权限是否需要全部导入若仅需实现「飞书发送消息、OpenClaw接收并自动回复」的基础功能可仅开通事件弹窗提示的必要权限。若后续需要使用文档、云空间、多维表格、知识库等拓展功能建议直接导入完整权限JSON避免后续权限缺失导致功能异常。五、官方参考地址飞书开放平台开发者后台开发者后台 - 飞书开放平台OpenClaw一键获取http://b.m6z.cn/hayK4
