OpenClaw 2.7.9 对接飞书机器人完整配置教程

本文讲解借助长连接模式打通 OpenClaw 与飞书的操作流程，配置完成后，可在飞书私聊、群组内发送指令，调用本地 AI 实现电脑自动化操作。整体流程分为飞书平台创建应用、权限配置、密钥填写三大环节。

OpenClaw 安装包：OpenClaw Windows 一键部署包 v2.7.9，压缩包大小 45.8MB。

前置准备

1. 本地已完成 OpenClaw 2.7.9 部署，Gateway 服务处于在线状态
2. 拥有可用飞书企业或组织空间，能够登录飞书开放开发者后台
3. 企业环境需具备管理员权限，用于应用版本审核；个人空间可直接发布，无需审核

一、飞书开放平台创建自建应用

打开飞书开发者后台：https://open.feishu.cn/app，进入页面后选择创建企业自建应用。自定义应用名称、机器人简介与应用图标，确认信息后完成应用创建。

二、添加机器人基础能力

在应用主页左侧点击添加应用能力，在功能列表中选中机器人组件并完成添加，该组件是实现消息收发的基础条件。

三、事件配置：选用长连接接收事件

进入【事件与回调】- 事件配置页面，订阅方式选择使用长连接接收事件，该方式无需配置公网回调地址，设置完成后保存。

点击添加事件，搜索并勾选 im.message.receive_v1（接收消息），按照弹窗指引开通事件配套权限，保证单聊、群内 @等相关权限全部启用。

四、批量导入全套权限 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: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": []
}
}

五、应用版本发布

进入版本管理与发布页面，新建版本并自定义版本号，例如 1.0.0。移动端、桌面端默认勾选机器人能力，填写版本备注后保存。 个人飞书空间可直接确认发布；企业主体则需要等待管理员审核通过后方可生效。

六、提取密钥填入 OpenClaw

返回应用基础信息页面，复制 App ID、App Secret 两组密钥。 打开 OpenClaw，点击右上角设置，进入聊天配置，找到 Feishu/Lark 选项。 粘贴已复制的两组密钥，开启渠道开关，保存所有配置项。

七、接入自检清单

• 飞书应用已成功添加机器人能力
• 事件订阅选择长连接模式，已添加 im.message.receive_v1 事件
• 事件权限、批量导入的全套权限均已正常开通
• 应用版本完成发布并生效
• AppID 与 App Secret 填写无误，OpenClaw 内聊天渠道配置已保存

八、常见问题排查

1. 机器人收不到消息：检查应用是否正常发布、事件订阅是否为长连接，确认密钥无多余空格，修改配置后重启 Gateway 服务。
2. 仅支持单聊、无法在群聊使用：补充群组相关权限，重新发布应用版本。
3. 无需额外填写公网地址：本方案基于飞书长连接协议实现，省去 webhook 域名配置步骤。

安装包下载地址

安卓版本：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

苹果系统版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C