飞书 ×OpenClaw：AI 智能体办公集成方案

OpenClaw 连接飞书图文教程

本文结合当前飞书开放平台页面、本目录里的截图素材，以及 OpenClaw Windows 现有飞书配置方式整理。 适用于“先在飞书开放平台创建企业自建应用，再把App ID和App Secret填回 OpenClaw”的接入流程。

先说结论：OpenClaw 当前飞书渠道页只需要填写App ID和App Secret两个参数；飞书侧推荐按本文选择“长连接接收事件”，并至少完成应用创建、机器人能力、事件订阅、权限开通、版本发布这 5 个环节。

open claw下载链接🔗：

最新版本下载https://xiake.yun/api/download/package/17?promoCode=IVD643FDE29A

前置准备

1. 已安装并能正常打开 OpenClaw Windows。

2. 已登录飞书开放平台，并能进入开发者后台。

3. 准备一个可用的飞书组织或企业空间。

4. 如果你是企业账号，发布版本时可能需要企业管理员审核。

图文步骤

步骤 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

回到左侧“凭证与基础信息”，复制这两个值：

1. App ID

2. App Secret

OpenClaw 端只需要这两个参数。

步骤 19：打开 OpenClaw 的飞书渠道配置页

回到 OpenClaw，点击右上角“设置”，进入“聊天配置”，找到Feishu/Lark（飞书）这张卡片。 把刚才复制的App ID和App Secret分别填进去。

步骤 20：启用飞书渠道并保存

确认右侧开关已经打开，最后点击右上角“保存渠道配置”。 保存后，飞书渠道就会在 OpenClaw 里处于已配置状态。

接入完成后的自检清单

1. 飞书应用已经添加“机器人”能力。

2. 事件与回调里使用的是“长连接接收事件”。

3. 已添加im.message.receive_v1事件。

4. 事件关联权限都显示为“已开通”。

5. 权限管理里完整权限已经导入或逐项开通。

6. 版本已经保存并发布。

7. App ID和App Secret已经正确填入 OpenClaw。

8. OpenClaw 里已点击“保存渠道配置”。

常见问题

1. OpenClaw 里填了参数，但飞书机器人没反应

优先检查下面几项：

1. 飞书应用是否真的已经发布成功。

2. 事件订阅是不是im.message.receive_v1。

3. 订阅方式是不是“长连接接收事件”。

4. OpenClaw 里保存渠道配置后，是否需要重启一次 Gateway。

5. App Secret复制时是否多了空格，或者拿错了旧值。

2. 为什么教程里没有要求填写公网回调地址

因为这套流程走的是飞书官方支持的“长连接”模式。 按当前 OpenClaw 的飞书配置方式，只需要App ID和App Secret，不需要你手动配置 webhook URL。

3. 权限一定要全部导入吗

如果你只想先跑通“飞书给机器人发消息，OpenClaw 能收到并回复”的最小流程，可以先按事件弹窗把必要权限开通。 但如果你希望后续配合 OpenClaw 使用文档、云空间、多维表格、知识库等能力，建议直接导入步骤 11 里的完整权限 JSON。

参考链接

1. 飞书开放平台开发者后台：开发者后台 - 飞书开放平台

open claw部署包：https://xiake.yun/api/download/package/17?promoCode=IVD643FDE29A