OpenClaw v2.7.9 对接飞书机器人完整图文部署教程🤖

一、接入前置准备清单✅

在开始飞书渠道配置前，需要提前准备好全部基础条件，减少配置过程中出现各类异常：

1. 本地电脑已安装 OpenClaw v2.7.9 客户端，程序能够正常打开启动
2. Windows 适配安装包：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C
3. macOS 适配安装包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
4. 整合包整体大小为 45.8MB
5. 拥有可正常登录的飞书开放平台开发者账号，能够完整操作后台各项配置功能
6. 准备一个可用的飞书企业组织 / 工作空间，用于机器人消息收发测试
7. 若使用企业类型飞书账号，应用版本发布环节需要企业管理员完成审核流程

整体接入思路

整套对接分为两大阶段：先在飞书开放平台搭建企业自建应用，完成机器人能力、事件订阅、权限、版本配置；再将平台生成的 App ID、App Secret 填入 OpenClaw 完成渠道绑定。 OpenClaw 飞书配置页面仅需录入两组参数即可完成连通；飞书侧推荐选用长连接接收事件模式，完整操作必须走完应用创建、机器人能力添加、事件订阅、权限开通、版本发布五个关键环节。

二、分步完整图文操作流程📋

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

浏览器打开飞书开放平台地址：https://open.feishu.cn/app 点击页面右上角「开发者后台」，在功能菜单中选择创建企业自建应用。

步骤 2：填写应用基础信息完成创建

自定义机器人应用名称、补充功能描述，头像可选用平台默认素材或者自行上传图片，信息核对完毕后点击创建按钮。

步骤 3：给应用添加机器人能力模块

进入应用详情页，点击左侧「添加应用能力」，在能力列表找到「机器人」选项，点击添加完成挂载。

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

左侧导航栏选择「事件与回调」，找到事件配置区域，点击订阅方式右侧的编辑按钮。

步骤 5：选择长连接模式并保存配置

订阅方式不要选择推送至开发者服务器，OpenClaw 适配长连接方案，无需额外准备公网回调地址；勾选「使用长连接接收事件」，保存当前设置。

步骤 6：添加消息监听事件

保存订阅方式后，在已添加事件板块点击右侧「添加事件」按钮。

步骤 7：绑定消息接收核心事件

在弹窗内搜索关键词「接收」，勾选im.message.receive_v1事件并确认添加。该事件是机器人捕获飞书私聊、群聊消息的核心配置，缺少后无法正常接收用户指令。

步骤 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.0.0、1.0.1；移动端、桌面端默认能力统一选择机器人；更新说明简单标注事件与权限优化即可。

步骤 16：保存版本配置

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

步骤 17：发布应用版本

保存完毕后点击「确认发布」；个人飞书空间可直接完成发布，企业账号需等待管理员审核通过。

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

左侧切换至「凭证与基础信息」页面，复制 App ID、App Secret 两组参数妥善保存，后续填入 OpenClaw。

提示：App Secret 属于私密密钥，不要截图、转发给无关人员。

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

切换至 OpenClaw v2.7.9 客户端，点击右上角「设置」，选择「聊天配置」，找到 Feishu/Lark（飞书）配置卡片，粘贴刚才复制的 App ID、App Secret。

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

打开渠道右侧启用开关，点击右上角「保存渠道配置」，飞书与本地 AI 智能体的绑定流程全部完成。

三、接入完成自检核对清单🔍

全部操作结束后逐项核对，避免配置缺失导致机器人失效：

1. 飞书自建应用已成功添加机器人能力模块
2. 事件订阅选用长连接接收事件模式
3. 已添加im.message.receive_v1消息接收核心事件
4. 事件关联的全部权限均显示已开通状态
5. 完整权限 JSON 已批量导入，无权限缺失
6. 应用新版本已保存并完成发布流程
7. App ID、App Secret 完整复制无多余空格，填入 OpenClaw 对应输入框
8. 飞书渠道开关已开启，且点击保存渠道配置

四、高频故障排查方案❓

1、参数全部填写完毕，飞书机器人无法回复消息

按顺序逐项排查：

1. 飞书应用版本是否成功发布，企业账号确认管理员已完成审核
2. 事件订阅是否配置im.message.receive_v1消息事件
3. 事件订阅模式是否选择长连接接收事件
4. OpenClaw 保存配置后，可重启 Gateway 服务刷新通道
5. App Secret 复制过程是否混入空格、字符缺失

2、教程未要求填写公网回调地址是什么原因

本次对接采用飞书官方长连接方案，依托 App ID、App Secret 即可建立通信链路，无需自行部署公网服务、填写 Webhook 回调地址，降低部署难度。

3、权限是否必须完整导入全套 JSON

仅测试收发消息时，开通事件配套基础权限即可；如果需要联动多维表格、文档、云空间、知识库等办公功能，建议直接导入完整权限 JSON，避免后续反复补充授权。

五、配套参考地址

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