OpenClaw 2.7.9 对接飞书完整图文部署教程

适配说明

当前教程适配 OpenClaw Windows 2.7.9 版本，采用飞书企业自建应用搭配长连接事件订阅方案，整套流程仅需 App ID、App Secret 两组参数完成绑定。飞书平台侧需完成五大核心操作：应用创建、机器人能力添加、事件订阅配置、权限开通、应用版本发布。

一、前期环境准备

1. 本地设备已成功安装并正常启动 OpenClaw Windows 客户端，安装包大小 45.8MB
2. Windows 系统安装包：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. MacOS 系统安装包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
4. 持有飞书企业或组织空间账号，能够正常登录飞书开放平台开发者后台
5. 使用企业账号操作的用户，需提前和企业管理员沟通，预留应用版本审核通道

二、飞书开放平台后台分步配置

步骤 1 新建企业自建应用

1. 访问飞书开放平台官网地址：https://open.feishu.cn/app
2. 点击页面右上角「开发者后台」，选择创建企业自建应用

步骤 2 完善应用基础信息

填写应用名称、功能简介，可选用平台默认头像或上传自定义图片，信息填写完毕后点击创建按钮。

步骤 3 为应用开启机器人能力

左侧导航栏点击「添加应用能力」，在能力列表检索关键词「机器人」，选中后完成添加。

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

点击左侧菜单栏「事件与回调」，找到事件订阅方式右侧的编辑按钮进入配置界面。

步骤 5 选择长连接接收事件（核心配置项）

订阅方式不要选择「将事件发送至开发者服务器」，勾选使用长连接接收事件，保存当前设置。 该方案优势：不用准备公网 IP 地址，无需手动填写 Webhook 回调链接，本地 OpenClaw 可直接对接飞书事件数据流。

步骤 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 确认批量新增权限

完整粘贴配置文本后，点击「下一步，确认新增权限」。

步骤 13 数据范围保持默认配置

部分权限会弹出数据访问范围设置窗口，全部保留默认选项「与应用的可用范围一致」，点击确认即可。

步骤 14 进入版本发布管理页面

权限、事件全部配置完成后，必须创建并发布应用版本，飞书侧所有配置才会正式生效。 页面顶部存在「创建版本」按钮可直接点击；无顶部按钮则从左侧「版本管理与发布」入口进入。

步骤 15 填写版本基础信息

在版本编辑页面完成以下设置：

1. 设置全新版本号，示例：1.0.0、1.0.1
2. 移动端、桌面端默认能力统一选择「机器人」
3. 更新说明填写简易内容，示例：更新事件订阅配置，完善权限范围

步骤 16 保存当前版本

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

步骤 17 提交发布申请

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

步骤 18 复制应用凭证参数

切换至左侧「凭证与基础信息」页面，复制两组关键参数：App ID、App Secret，后续 OpenClaw 配置仅需这两组内容。

三、OpenClaw 客户端渠道配置流程

步骤 19 打开飞书渠道配置面板

启动本地 OpenClaw 2.7.9，点击页面右上角「设置」，进入「聊天配置」板块，找到 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
8. OpenClaw 内渠道配置执行保存操作

五、高频问题排查方案

问题 1：参数填写完成，但飞书机器人无法响应消息

优先按以下顺序逐项核查：

1. 飞书应用版本是否审核、发布成功
2. 事件订阅是否添加im.message.receive_v1
3. 事件订阅方式是否选择长连接接收事件
4. OpenClaw 保存渠道配置后，尝试重启 Gateway 服务
5. 复制 App Secret 时是否附带多余空格，或使用过期凭证

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

本次接入方案采用飞书官方长连接交互模式，基于 OpenClaw 当前适配逻辑，仅填写 App ID 与 App Secret 即可完成对接，不需要手动配置 Webhook 回调链接。

问题 3：权限是否必须导入完整 JSON 内容

仅测试机器人收发消息基础功能，可仅开通事件弹窗提示的基础权限；若需要联动多维表格、云文档、知识库、白板等拓展功能，建议直接导入完整权限 JSON，避免后续反复补充权限。

六、参考平台地址

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