OpenClaw 2.7.9 对接飞书机器人长连接模式完整配置指南

本文结合飞书开放平台操作界面、配套截图素材以及 Windows 端 OpenClaw 2.7.9 内置飞书渠道配置逻辑整理而成。整套流程采用「飞书开放平台搭建企业自建应用，提取 App ID 与 App Secret 填入 OpenClaw」的接入方案。

核心接入要点

OpenClaw 飞书渠道仅需录入 App ID、App Secret 两组凭证即可完成基础配置；飞书平台侧推荐采用长连接方式接收消息事件，整套部署流程分为五大关键环节：应用创建、机器人能力开启、事件订阅配置、权限批量开通、应用版本发布。

前置准备

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

分步完整操作流程

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

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

步骤 2：填写应用基础信息

自定义机器人应用名称，补充简短功能描述，选用平台默认头像或上传自定义图片，确认信息后点击创建。

步骤 3：为应用开启机器人功能模块

进入应用后台，点击左侧「添加应用能力」，在能力列表找到机器人选项，点击添加完成功能开通。

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

左侧导航栏选择「事件与回调」，在事件配置板块点击订阅方式右侧编辑按钮，开启修改权限。

步骤 5：切换为长连接事件接收模式并保存

配置时不要选择「将事件发送至开发者服务器」。当前 OpenClaw 对接方案无需配置公网回调地址，直接选中「使用长连接接收事件」，保存设置。

步骤 6：添加消息订阅事件

订阅方式保存完成后，在已添加事件区域点击右侧添加事件按钮。

步骤 7：勾选接收消息核心事件

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

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

若页面弹出推荐开通权限提示，直接点击确认开通权限。

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

返回事件列表，展开事件下方权限详情，确保所有权限状态均为已开通。存在未开通项时，点击权限名称完成补充开通。

步骤 10：进入权限管理，准备批量导入权限

左侧菜单栏打开权限管理页面，点击批量导入 / 导出权限功能按钮。

步骤 11：粘贴完整权限 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 仅需这两组参数完成对接。

步骤 19：OpenClaw 2.7.9 配置飞书渠道

打开 OpenClaw 2.7.9，点击右上角设置，进入聊天配置板块，找到 Feishu/Lark 飞书配置卡片，将复制的 App ID、App Secret 分别填入对应输入框。

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

开启飞书渠道右侧开关，点击右上角保存渠道配置，保存后飞书渠道即完成全部部署。

部署完成自检核对清单

1. 飞书自建应用已添加机器人能力
2. 事件与回调订阅方式设置为长连接接收事件
3. 成功添加 im.message.receive_v1 接收消息事件
4. 事件配套权限全部显示已开通状态
5. 权限管理页面完整导入全套权限 JSON
6. 应用版本已保存并提交发布
7. App ID、App Secret 准确填写至 OpenClaw 2.7.9 飞书配置栏
8. OpenClaw 内执行保存渠道配置操作

高频问题排查方案

1. 参数填写完成，但飞书机器人无任何响应

按照以下顺序逐项排查：

1. 飞书应用是否成功发布完成，未审核通过的版本无法生效
2. 事件订阅是否选定 im.message.receive_v1
3. 事件接收模式是否为长连接接收事件，未选错 webhook 模式
4. OpenClaw 保存渠道配置后，可重启 Gateway 网关重试
5. 复制 App Secret 时是否带入多余空格，或使用过期密钥

2. 本方案无需填写公网回调地址的原因

整套对接流程采用飞书原生支持的长连接通信模式，当前 OpenClaw 2.7.9 飞书渠道仅依靠 App ID、App Secret 建立通信链路，无需手动部署公网 Webhook 地址。

3. 是否必须导入全套权限 JSON

仅实现基础收发消息功能，可仅开通事件弹窗自带的基础权限；如果需要借助 OpenClaw 操作飞书文档、多维表格、云空间、知识库等拓展功能，建议直接导入完整权限 JSON，避免后续权限缺失。

参考链接

飞书开放平台开发者后台：企业飞书空间接入 OpenClaw 2.7.9 机器人避坑教程