企业官网建设流程全解析

OpenClaw 连接飞书图文实操教程

本文结合飞书开放平台后台界面、配套截图素材以及 OpenClaw v2.7.9 内置飞书渠道配置逻辑整理完整操作流程，整体方案逻辑为先在飞书开放平台搭建企业自建应用，再将应用生成的 App ID、App Secret 填入 OpenClaw 客户端完成联动。

整体接入核心要点：OpenClaw v2.7.9 飞书渠道仅需录入 App ID、App Secret 两项参数；飞书应用侧推荐采用长连接模式接收推送事件，整套部署需要完成应用创建、机器人能力添加、事件订阅配置、权限批量开通、版本发布五大核心环节。

前置环境准备

1. 本地已部署 OpenClaw v2.7.9 Windows 客户端，程序可正常启动运行；
2. 登录飞书开放平台，能够正常进入开发者后台页面；
3. 持有可用飞书企业组织或团队空间；
4. 企业类型账号发布应用版本时，需要企业管理员完成审核流程。

OpenClaw 整合资源包大小 45.8MB

Windows 安装包下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

macOS 安装包下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

完整图文操作步骤

步骤 1：访问飞书开放平台，创建企业自建应用

打开飞书开放平台地址：https://open.feishu.cn/app 进入页面后点击右上角开发者后台入口，选择创建企业自建应用。

步骤 2：完善应用基础信息

自定义机器人应用名称，补充简短功能描述，可选用系统默认头像或上传自定义图标，填写完成后点击创建按钮生成应用。

步骤 3：为应用新增机器人能力

进入应用配置主页，点击左侧添加应用能力，在能力列表中找到机器人模块，点击添加完成能力开通。

步骤 4：进入事件与回调配置页面

左侧菜单栏选择事件与回调板块，在事件配置区域找到订阅方式，点击编辑按钮进入修改页面。

步骤 5：选定长连接接收事件并保存设置

配置页面不要选择事件推送至开发者服务器选项，OpenClaw v2.7.9 适配长连接接入方案，无需额外配置公网回调地址，选中使用长连接接收事件后保存配置。

步骤 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.1；
2. 移动端、桌面端默认能力统一勾选机器人；
3. 更新说明简单标注配置变更内容，如更新事件订阅、补充全量权限。

步骤 16：保存当前版本配置

滑动页面至底部，点击保存按钮存储版本信息。

步骤 17：执行版本发布操作

版本保存完成后点击确认发布。个人账号一般可直接完成发布；企业账号提交后需等待企业管理员审核通过方可生效。

步骤 18：复制 App ID 与 App Secret 凭证

切换至左侧凭证与基础信息页面，复制页面展示的 App ID、App Secret 两组参数，后续填入 OpenClaw 客户端。

步骤 19：OpenClaw v2.7.9 飞书渠道参数填写

切换至 OpenClaw 客户端，点击右上角设置，进入聊天配置分类，找到 Feishu/Lark（飞书）配置卡片，将复制的 App ID、App Secret 分别填入对应输入框。

步骤 20：开启渠道开关并保存配置

打开飞书渠道右侧启用开关，点击右上角保存渠道配置，完成 OpenClaw 与飞书应用的联动部署。

接入完成自检核对清单

1. 飞书自建应用已成功添加机器人能力；
2. 事件与回调订阅方式设置为长连接接收事件；
3. 已添加 im.message.receive_v1 消息接收事件；
4. 事件关联配套权限全部处于已开通状态；
5. 权限管理页面已导入完整权限 JSON 或手动补齐所需权限；
6. 应用新版本已保存并完成发布；
7. App ID、App Secret 参数完整无误填入 OpenClaw v2.7.9；
8. OpenClaw 内点击保存渠道配置，渠道处于启用状态。

高频问题排查方案

1. 参数填写完成后，飞书机器人无任何消息响应

按顺序逐项排查： ① 飞书应用版本是否成功发布，企业账号确认管理员审核已通过； ② 事件订阅是否添加 im.message.receive_v1 消息接收事件； ③ 事件订阅方式是否选定长连接接收事件； ④ OpenClaw 保存渠道配置后，可尝试重启 Gateway 服务； ⑤ App Secret 复制时是否携带多余空格、换行，或使用过期密钥。

2. 整套流程无需填写公网回调地址的原因

本次接入方案采用飞书官方长连接交互模式，OpenClaw v2.7.9 内置连接通道，仅依靠 App ID、App Secret 即可完成通信，无需手动配置 Webhook 公网回调地址。

3. 是否必须导入全套权限 JSON

仅实现基础收发消息功能，可只开通事件弹窗提示的必要权限；若需要完整使用 OpenClaw 配套的多维表格、在线文档、云空间、知识库等联动能力，建议直接导入完整权限 JSON，避免后续权限缺失报错。

配套参考链接

飞书开放平台开发者后台：https://open.feishu.cn/app