OpenClaw 连接飞书完整部署教程本文结合飞书开放平台页面布局、配套素材与 OpenClaw Windows 客户端内置飞书对接逻辑整理整体采用标准化接入流程先在飞书开放平台搭建企业自建应用提取凭证后填入 OpenClaw 客户端完成连通。核心要点总结OpenClaw 2.7.9 飞书渠道配置面板仅需录入 App ID、App Secret 两组凭证飞书应用端推荐选用长连接模式接收交互事件完整落地需要走完五大核心环节应用创建、机器人能力启用、事件订阅配置、权限批量开通、版本上线发布。一、前期部署准备本地已部署 OpenClaw 2.7.9 Windows 客户端程序可正常启动运行拥有飞书开放平台账号能够正常登录开发者后台完成应用配置准备可用的飞书企业或组织空间用于承载自建机器人应用企业类型账号发布应用版本时需要企业管理员完成线上审核工具安装包资源压缩包体积 45.8MB内置完整运行依赖解压后可直接部署使用。Windows 系统安装包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CMacOS 系统安装包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 文本{ 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 客户端。步骤 19打开 OpenClaw 飞书渠道配置界面切换至 OpenClaw 客户端点击右上角设置进入聊天配置板块找到 Feishu/Lark 飞书配置卡片将复制的 App ID、App Secret 分别填入对应输入框。步骤 20启用渠道并保存配置开启飞书渠道右侧开关点击右上角保存渠道配置完成 OpenClaw 与飞书的对接部署。三、接入完成自检清单飞书应用已成功添加机器人能力事件与回调订阅方式设置为长连接接收事件已添加 im.message.receive_v1 消息接收事件事件关联全部权限显示已开通状态权限管理完成全套权限 JSON 导入或逐项开通应用新版本已保存并完成发布App ID 与 App Secret 凭证准确录入 OpenClawOpenClaw 端已执行保存渠道配置操作四、常见故障问题排查1. 参数填写完成后飞书机器人无交互反馈按优先级依次核对以下内容飞书应用版本是否发布审核完成事件订阅是否为 im.message.receive_v1事件订阅方式是否选择长连接接收事件OpenClaw 保存渠道配置后重启 Gateway 网关服务复制 App Secret 时是否附带多余空格、是否使用过期凭证2. 本方案无需填写公网回调地址原因整套对接流程采用飞书官方长连接交互模式OpenClaw 2.7.9 内置对应适配逻辑仅依靠 App ID 与 App Secret 即可建立通信无需手动填写 Webhook 回调地址。3. 权限 JSON 是否必须完整导入仅实现机器人收发消息基础功能可跟随事件弹窗开通最小必要权限若需要联动飞书文档、多维表格、云盘、知识库等拓展能力建议直接导入完整权限 JSON 避免后续权限缺失报错。参考链接飞书开放平台开发者后台https://open.feishu.cn/app
飞书长连接模式对接 OpenClaw 无需配置 Webhook 完整步骤（含安装包）
OpenClaw 连接飞书完整部署教程本文结合飞书开放平台页面布局、配套素材与 OpenClaw Windows 客户端内置飞书对接逻辑整理整体采用标准化接入流程先在飞书开放平台搭建企业自建应用提取凭证后填入 OpenClaw 客户端完成连通。核心要点总结OpenClaw 2.7.9 飞书渠道配置面板仅需录入 App ID、App Secret 两组凭证飞书应用端推荐选用长连接模式接收交互事件完整落地需要走完五大核心环节应用创建、机器人能力启用、事件订阅配置、权限批量开通、版本上线发布。一、前期部署准备本地已部署 OpenClaw 2.7.9 Windows 客户端程序可正常启动运行拥有飞书开放平台账号能够正常登录开发者后台完成应用配置准备可用的飞书企业或组织空间用于承载自建机器人应用企业类型账号发布应用版本时需要企业管理员完成线上审核工具安装包资源压缩包体积 45.8MB内置完整运行依赖解压后可直接部署使用。Windows 系统安装包https://xiake.yun/api/download/package/18?promoCodeIV4E9B04A80CMacOS 系统安装包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 文本{ 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 客户端。步骤 19打开 OpenClaw 飞书渠道配置界面切换至 OpenClaw 客户端点击右上角设置进入聊天配置板块找到 Feishu/Lark 飞书配置卡片将复制的 App ID、App Secret 分别填入对应输入框。步骤 20启用渠道并保存配置开启飞书渠道右侧开关点击右上角保存渠道配置完成 OpenClaw 与飞书的对接部署。三、接入完成自检清单飞书应用已成功添加机器人能力事件与回调订阅方式设置为长连接接收事件已添加 im.message.receive_v1 消息接收事件事件关联全部权限显示已开通状态权限管理完成全套权限 JSON 导入或逐项开通应用新版本已保存并完成发布App ID 与 App Secret 凭证准确录入 OpenClawOpenClaw 端已执行保存渠道配置操作四、常见故障问题排查1. 参数填写完成后飞书机器人无交互反馈按优先级依次核对以下内容飞书应用版本是否发布审核完成事件订阅是否为 im.message.receive_v1事件订阅方式是否选择长连接接收事件OpenClaw 保存渠道配置后重启 Gateway 网关服务复制 App Secret 时是否附带多余空格、是否使用过期凭证2. 本方案无需填写公网回调地址原因整套对接流程采用飞书官方长连接交互模式OpenClaw 2.7.9 内置对应适配逻辑仅依靠 App ID 与 App Secret 即可建立通信无需手动填写 Webhook 回调地址。3. 权限 JSON 是否必须完整导入仅实现机器人收发消息基础功能可跟随事件弹窗开通最小必要权限若需要联动飞书文档、多维表格、云盘、知识库等拓展能力建议直接导入完整权限 JSON 避免后续权限缺失报错。参考链接飞书开放平台开发者后台https://open.feishu.cn/app
