OpenClaw 2.7.9 连接飞书完整实操配置教程

📦 安装包大小：45.8MB

💻 Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

🍎 Mac 苹果系统下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

本文结合飞书开放平台页面布局、配套素材以及 OpenClaw 2.7.9 Windows 客户端内置飞书渠道配置逻辑整理而成。整套方案适用于先在飞书开放平台搭建企业自建应用，再提取 App ID、App Secret 填入 OpenClaw 完成对接的标准化流程。

💡 核心要点总结

OpenClaw 2.7.9 飞书渠道配置仅需录入 App ID、App Secret 两组凭证；飞书应用侧推荐选用长连接接收事件模式，完整落地需要走完五大核心环节：应用创建、机器人能力新增、事件订阅配置、接口权限开通、应用版本发布。

📋 前期准备事项

全部条件确认完毕再开始配置，减少中途报错概率：

1. 本地设备安装 OpenClaw 2.7.9 Windows 客户端，软件可正常启动运行
2. 拥有飞书开放平台登录账号，可正常进入开发者后台页面
3. 具备可用飞书企业组织或独立空间资源
4. 企业类型账号在发布应用版本阶段，需等待企业管理员完成审核

---

🔧 分步完整配置流程

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

打开飞书开放平台访问地址：https://open.feishu.cn/app 进入首页后点击页面右上角「开发者后台」，选择「创建企业自建应用」功能入口。

步骤 2：完善应用基础展示信息

自定义填写机器人应用名称、功能描述，可选用系统默认头像或上传自定义图片，填写完成点击创建按钮生成应用。

步骤 3：为应用新增机器人核心能力

进入应用管理主页，点击左侧菜单栏「添加应用能力」，在能力列表检索「机器人」，选中后点击添加完成部署。

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

左侧导航栏切换至「事件与回调」栏目，找到事件配置区域，点击订阅方式右侧编辑按键。

步骤 5：选定长连接接收事件并保存

请勿切换至事件推送至自有服务器模式。OpenClaw 2.7.9 配套的飞书对接方案不需要单独部署公网回调地址，选择「使用长连接接收事件」，完成设置后点击保存。

步骤 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：确认批量导入权限

JSON 内容粘贴完成后，点击「下一步，确认新增权限」提交权限配置。

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

部分权限会弹出数据范围选择窗口，统一选用默认选项「与应用的可用范围一致」，点击确认保存。

步骤 14：进入版本管理页面创建新版本

权限、事件全部配置完成后需要发布应用版本，所有配置才能正式生效。页面顶部存在「创建版本」按钮可直接点击；无顶部按钮则通过左侧「版本管理与发布」栏目进入。

步骤 15：填写版本基础信息

在版本编辑页面完成信息填写：

1. 设置全新版本号，例如 1.0.0、1.0.1
2. 移动端、桌面端默认能力均选择机器人
3. 更新说明可简单填写，示例：更新事件订阅配置、批量导入全量接口权限

步骤 16：保存版本配置

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

步骤 17：提交发布应用版本

版本保存完成后点击确认发布。个人飞书空间发布流程无额外审核；企业主体账号提交发布后，需要企业管理员审核通过才能正式生效。

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

左侧导航栏切换至「凭证与基础信息」页面，复制两组关键参数：

1. App ID
2. App Secret 两组参数是 OpenClaw 飞书渠道配置的唯一凭证。

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

切换至 OpenClaw 客户端操作：

1. 点击软件右上角设置按钮
2. 左侧菜单栏选择聊天配置
3. 在渠道列表找到 Feishu/Lark（飞书）配置卡片 将上一步复制的 App ID、App Secret 分别填入对应输入框。

步骤 20：启用渠道并保存全部配置

确认飞书渠道右侧开关处于开启状态，点击页面右上角保存渠道配置，完成 OpenClaw 端全部对接设置。

---

✅ 接入完成自检核对清单

配置结束后逐项核对，避免遗漏步骤导致功能异常：

• 飞书自建应用已成功添加机器人应用能力
• 事件与回调订阅方式设置为长连接接收事件
• 已添加 im.message.receive_v1 消息接收事件
• 事件绑定的配套权限全部显示已开通状态
• 权限管理页面完成完整权限 JSON 批量导入
• 应用新版本已保存并完成发布审核
• App ID、App Secret 完整复制无多余空格、字符缺失
• OpenClaw 飞书渠道参数填写完毕并点击保存渠道配置

---

❓ 常见问题排查指南

1. OpenClaw 参数填写完成，飞书机器人无法回复消息

按以下顺序逐项校验定位故障：

1. 确认飞书应用版本审核完成、发布状态正常
2. 核对事件订阅是否添加 im.message.receive_v1 消息事件
3. 检查事件订阅方式是否选择长连接接收事件
4. OpenClaw 保存渠道配置后，可重启 Gateway 网关重新加载配置
5. 核对 App Secret 复制内容，避免空格、复制不全、使用旧密钥

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

整套对接流程采用飞书官方长连接 WebSocket 方案，OpenClaw 主动与飞书服务建立持久连接推送消息，无需自行部署公网 Webhook 地址，内网环境也可正常使用。

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

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

---

📎 参考链接

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

 💻 Windows 客户端下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

🍎 Mac 苹果系统下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C