OpenClaw 2.7.9 对接飞书机器人完整图文实操教程

文档概述

本文基于飞书开放平台后台界面、配套截图素材以及 OpenClaw Windows 客户端现有飞书渠道配置逻辑整理编写，采用企业自建应用 + 长连接接收事件接入方案，整套流程仅需填写 App ID、App Secret 两项参数即可完成对接。 完整落地流程分为五大核心环节：应用创建、机器人能力配置、事件订阅、权限批量开通、应用版本发布，最后在 OpenClaw 客户端录入凭证启用飞书通信渠道。

前置环境要求

1. 本地设备已部署 OpenClaw 2.7.9 Windows 客户端，程序可正常启动运行，安装包大小 45.8MB
2. Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. 苹果系统客户端下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
4. 持有飞书开发者账号，能够正常登录飞书开放平台开发者后台
5. 拥有可用的飞书企业 / 组织空间用于创建机器人应用
6. 企业类型飞书空间：应用版本提交发布后，需要企业管理员完成审核流程

完整分步操作流程

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

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

1. 页面右上角点击「开发者后台」完成账号登录
2. 在应用创建分类中选择「创建企业自建应用」 

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

自定义设置应用名称、功能介绍文字，可选用系统默认头像或上传自定义图标，信息填写完成后点击「创建」按钮保存应用。 

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

1. 应用左侧导航栏选择「添加应用能力」
2. 在能力列表检索「机器人」选项，选中后点击添加 

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

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

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

订阅方式禁止选择「将事件发送至开发者服务器」，统一勾选「使用长连接接收事件」并保存设置。 该方案无需准备公网服务器与回调地址，适配本地运行的 OpenClaw 2.7.9 客户端架构。 

步骤 6：新增消息监听事件条目

保存订阅方式配置后，在「已添加事件」区域点击「添加事件」按钮。

步骤 7：添加消息接收核心事件 im.message.receive_v1

在弹出的事件选择窗口搜索关键词「接收」，勾选事件im.message.receive_v1（接收消息），确认添加。 该事件是飞书机器人接收对话消息的核心配置项，缺失后 OpenClaw 无法捕获飞书内发给机器人的消息内容。 

步骤 8：一键开通事件配套基础权限

系统弹出权限推荐开通弹窗时，直接点击「确认开通权限」批量授予事件运行所需基础权限。 

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

展开已添加事件下方的权限明细列表，全部权限状态必须显示为「已开通」；若存在未开通权限，点击对应权限名称手动完成授权。 

步骤 10：打开权限批量导入功能

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

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

1. 清空导入输入框内原有默认文本内容
2. 复制下方完整权限 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 2.7.9 客户端飞书渠道仅需这两组凭证即可完成配置。 配套截图：18.png

步骤 19：打开 OpenClaw 飞书渠道配置界面

启动本地 OpenClaw 2.7.9 Windows 客户端，点击页面右上角「设置」，进入「聊天配置」板块，找到 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. OpenClaw 录入凭证后，飞书机器人无任何交互反馈

按优先级依次检查以下内容：

1. 飞书应用版本是否发布成功，企业账号确认管理员审核已通过
2. 事件订阅是否添加im.message.receive_v1，未选错其他事件
3. 事件订阅方式是否为长连接模式，未切换至开发者服务器回调
4. OpenClaw 保存渠道配置后，尝试重启 Gateway 服务
5. App Secret 复制时存在多余空格，或使用旧版本凭证

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

本次接入方案采用飞书官方支持的长连接交互模式，适配 OpenClaw 2.7.9 本地客户端运行架构，仅依靠 App ID、App Secret 完成鉴权通信，无需手动配置 Webhook 回调链接。

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

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

---

参考访问链接

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