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

本文详解通过长连接方式把 OpenClaw 和飞书打通，完成后可在飞书私聊 / 群组发送指令，调用本地 AI 完成电脑自动化操作，整体分为飞书平台创建应用、权限配置、密钥填写三大环节。

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

前置准备

1. 本地已装好 OpenClaw2.7.8，Gateway 服务处于在线状态；
2. 拥有可用飞书企业 / 组织空间，可登录飞书开放开发者后台；
3. 企业管理员权限用于应用版本审核（个人空间可免审发布）。

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

1. 打开飞书开发者后台https://open.feishu.cn/app，进入开发者后台，选择创建企业自建应用；
2. 自定义应用名称、机器人描述、应用图标，确认完成应用创建。

二、添加机器人基础能力

应用主页左侧「添加应用能力」，在列表找到机器人组件并添加，该组件是实现消息收发的基础。

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

1. 进入【事件与回调】- 事件配置，订阅方式选择使用长连接接收事件（无需配置公网回调地址）并保存；
2. 点击添加事件，搜索勾选im.message.receive_v1（接收消息）；
3. 跟随弹窗提示一键开通事件所需配套权限，确保单聊、群 @相关权限全部处于已开通。

四、批量导入全套权限 JSON

1. 左侧打开权限管理→批量导入 / 导出权限；
2. 清空原有默认内容，粘贴下方完整权限配置：

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. 点击下一步新增权限，权限数据范围保持默认配置并确认。

五、应用版本发布

1. 进入版本管理与发布，新建版本，版本号自定义（如 1.0.0），移动端、桌面端默认能力勾选机器人；
2. 填写版本备注后保存，个人空间直接确认发布，企业主体等待管理员审核通过。

六、提取密钥填入 OpenClaw

1. 返回基础信息页面，复制App ID、App Secret两组密钥；
2. 打开 OpenClaw→右上角设置→聊天配置→找到 Feishu/Lark；
3. 粘贴两组密钥，开启渠道开关，保存全部配置。

七、接入自检清单

• 飞书应用已添加机器人能力
• 事件订阅为长连接、已添加 im.message.receive_v1 事件
• 事件关联权限、批量导入权限全部开通
• 应用版本发布生效
• AppID 与 Secret 无误，OpenClaw 渠道配置已保存

八、常见问题排查

1. 机器人收不到消息：核查应用是否发布、订阅方式是否长连接、密钥无多余空格，保存配置后重启 Gateway；
2. 只能单聊无法群聊：补充群组相关权限，重新发布应用版本；
3. 无需填写公网地址：本方案依托飞书长连接协议，省去 webhook 域名配置。

备用下载：OpenClaw Windows 一键部署包 v2.7.8