企业官网建设流程全解析

本文结合当前飞书开放平台页面、本目录里的截图素材，以及 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.1

• 2、端能力配置：移动端、桌面端默认能力均保持为「机器人」

• 3、更新说明：简单备注即可，示例：更新事件订阅、完善应用权限配置

步骤16：保存应用版本

下拉页面至底部，点击「保存」，完成新版本信息存储。

步骤17：发布应用版本

版本保存成功后，点击「确认发布」。个人账号通常可直接免审核发布；企业账号需等待企业管理员审核通过后，版本方可正式生效。

步骤18：获取应用核心凭证

返回应用左侧菜单栏「凭证与基础信息」，复制App ID和App Secret两个核心参数，后续OpenClaw配置需使用这两个凭证。

步骤19：OpenClaw飞书渠道配置

打开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