OpenClaw 连接飞书完整部署教程

本文结合飞书开放平台页面布局、配套素材与 OpenClaw Windows 客户端内置飞书对接逻辑整理，整体采用标准化接入流程：先在飞书开放平台搭建企业自建应用，提取凭证后填入 OpenClaw 客户端完成连通。

核心要点总结

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

一、前期部署准备

1. 本地已部署 OpenClaw 2.7.9 Windows 客户端，程序可正常启动运行
2. 拥有飞书开放平台账号，能够正常登录开发者后台完成应用配置
3. 准备可用的飞书企业或组织空间，用于承载自建机器人应用
4. 企业类型账号发布应用版本时，需要企业管理员完成线上审核

工具安装包资源

压缩包体积 45.8MB，内置完整运行依赖，解压后可直接部署使用。

Windows 系统安装包：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

MacOS 系统安装包：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

二、分步部署操作流程

步骤 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，后续填入 OpenClaw 客户端。

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

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

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

开启飞书渠道右侧开关，点击右上角保存渠道配置，完成 OpenClaw 与飞书的对接部署。

三、接入完成自检清单

1. 飞书应用已成功添加机器人能力
2. 事件与回调订阅方式设置为长连接接收事件
3. 已添加 im.message.receive_v1 消息接收事件
4. 事件关联全部权限显示已开通状态
5. 权限管理完成全套权限 JSON 导入或逐项开通
6. 应用新版本已保存并完成发布
7. App ID 与 App Secret 凭证准确录入 OpenClaw
8. OpenClaw 端已执行保存渠道配置操作

四、常见故障问题排查

1. 参数填写完成后飞书机器人无交互反馈

按优先级依次核对以下内容：

• 飞书应用版本是否发布审核完成
• 事件订阅是否为 im.message.receive_v1
• 事件订阅方式是否选择长连接接收事件
• OpenClaw 保存渠道配置后重启 Gateway 网关服务
• 复制 App Secret 时是否附带多余空格、是否使用过期凭证

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

整套对接流程采用飞书官方长连接交互模式，OpenClaw 2.7.9 内置对应适配逻辑，仅依靠 App ID 与 App Secret 即可建立通信，无需手动填写 Webhook 回调地址。

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

仅实现机器人收发消息基础功能，可跟随事件弹窗开通最小必要权限；若需要联动飞书文档、多维表格、云盘、知识库等拓展能力，建议直接导入完整权限 JSON 避免后续权限缺失报错。

参考链接

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