企业官网建设流程全解析

OpenClaw 2.7.9 连接飞书完整实操教程

本文基于飞书开放平台后台操作逻辑、OpenClaw Windows 2.7.9 客户端渠道配置逻辑整理，采用企业自建应用搭配长连接接收事件的对接方案，整套配置仅需要 App ID、App Secret 两组参数即可完成两端打通。

核心要点梳理

1. OpenClaw 飞书渠道配置仅录入 App ID、App Secret 两项参数；
2. 飞书后台完整配置分为五大核心环节：创建自建应用、开启机器人能力、配置长连接事件订阅、批量开通应用权限、发布应用版本；
3. 统一选用长连接接收事件模式，无需额外部署公网服务，不用手动填写回调地址。

前置环境准备

1. 本地已下载安装 OpenClaw 2.7.9 Windows 客户端，安装包体积 45.8MB，下载地址：Windows 版本 https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C；苹果系统版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C，客户端可正常启动运行；
2. 拥有飞书开放平台开发者账号，能够正常登录开发者后台；
3. 具备可用的飞书企业或组织空间；
4. 企业类型账号发布应用版本时，需要企业管理员完成审核操作；个人自建应用发布流程无额外审核步骤。

分步配置操作流程

步骤 1：登录飞书开放平台，新建企业自建应用

访问飞书开放平台地址：https://open.feishu.cn/app

1. 页面右上角点击「开发者后台」；
2. 在应用创建分类中选择「创建企业自建应用」。

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

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

步骤 3：为应用启用机器人核心能力

1. 左侧导航栏点击「添加应用能力」；
2. 在能力列表检索机器人相关模块，点击添加完成能力开通。

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

左侧菜单栏打开「事件与回调」板块，在事件订阅设置区域点击订阅方式右侧编辑按钮。

步骤 5：选定长连接接收事件（关键配置项）

不要切换至「将事件发送至开发者服务器」选项，OpenClaw 适配长连接交互模式，无需公网回调地址：

1. 选中「使用长连接接收事件」选项；
2. 点击保存按钮完成当前设置。

步骤 6：新增消息接收事件项

订阅方式保存完毕后，在「已添加事件」区域右侧点击「添加事件」按钮。

步骤 7：添加机器人收消息核心事件

弹出的事件选择窗口内搜索关键词 “接收”，勾选im.message.receive_v1（接收消息）事件，点击添加确认。 该事件是飞书机器人接收对话消息的核心依赖，缺失此事件会导致 OpenClaw 无法捕获飞书内发送给机器人的消息。

步骤 8：一键开通事件配套推荐权限

页面弹出权限开通提示弹窗时，直接点击「确认开通权限」，系统会自动补齐当前事件基础依赖权限。

步骤 9：校验事件全部关联权限状态

返回事件列表页面，展开事件下方权限详情栏，逐项确认所有权限均显示为已开通；若存在未开通权限条目，点击对应权限名称手动完成开通。

步骤 10：权限管理入口，开启批量导入功能

左侧导航切换至「权限管理」页面，点击页面内「批量导入 / 导出权限」功能按钮。

步骤 11：粘贴完整权限 JSON 批量授权

清空导入窗口内原有默认文本，完整复制下方 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，后续 OpenClaw 客户端配置仅需这两项内容。

步骤 19：OpenClaw 客户端飞书渠道配置

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

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

确认飞书渠道右侧启用开关处于打开状态，点击右上角保存渠道配置按钮，保存完成即代表飞书渠道配置完毕。

接入完成自检清单

配置全部操作结束后，可对照以下条目逐项核对，避免配置遗漏：

1. 飞书自建应用已成功添加机器人应用能力；
2. 事件与回调模块订阅方式选择长连接接收事件；
3. 已添加im.message.receive_v1消息接收事件；
4. 事件配套全部依赖权限状态均为已开通；
5. 权限管理页面已导入完整权限 JSON 或逐项开通所需权限；
6. 应用新版本已保存并完成发布；
7. App ID、App Secret 参数准确录入 OpenClaw 客户端；
8. OpenClaw 客户端内已点击保存渠道配置。

常见问题排查方案

1. 参数填写完成，飞书机器人无交互响应

优先按顺序检查以下配置项：

• 飞书应用版本是否发布成功；
• 事件订阅是否添加im.message.receive_v1；
• 事件订阅方式是否为长连接接收事件；
• OpenClaw 保存渠道配置后，可尝试重启 Gateway 服务；
• 复制 App Secret 时是否附带多余空格，或使用旧版本凭证。

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

本次对接方案采用飞书官方支持的长连接交互模式，基于 OpenClaw 2.7.9 客户端适配逻辑，仅录入 App ID、App Secret 即可完成消息交互，不需要手动配置 Webhook 回调地址。

3. 权限是否必须完整导入 JSON

仅实现机器人收发消息基础交互时，可仅开通事件弹窗提示的基础权限；若后续需要搭配 OpenClaw 使用文档、云空间、多维表格、知识库等拓展功能，建议直接导入文中完整权限 JSON，避免后续反复补充权限。

参考访问地址

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