OpenClaw（原 Clawdbot）最新版本正式上线飞书适配功能，这款能深度操控本地系统的 AI 工具终于可以在飞书端实现无缝调用了！不管是日常的文档处理、消息交互，还是个性化的工作流搭建，打通飞书后的 OpenClaw 都能带来更贴合国内办公场景的体验。这篇喂饭级教程，手把手教你完成 OpenClaw 与飞书的全流程对接，零基础也能轻松上手。
先说明一个小细节：目前 OpenClaw 飞书机器人暂不支持接收图片 / 附件，仅可处理纯文本消息，若有相关需求可通过文字描述问题、跨平台发送截图或直接说明修改建议这三种方式解决，不影响核心功能使用。
一、创建飞书企业自建应用
-
登录飞书开放平台（https://open.feishu.cn/app），进入开发者后台，选择创建企业自建应用；
-
按要求填写应用名称（如 OpenClaw）、应用描述，上传符合要求的应用图标（JPEG/PNG/SVG/BMP 格式，2MB 以内，大于 240*240px，无圆角），选择背景色后点击创建；
-
应用创建成功后，进入应用详情页，点击左侧凭证与基础信息，记录下APP ID和APP Secret，后续配置会频繁用到，建议保存至本地文档或直接写入 OpenClaw 的.env 文件。
二、配置应用能力与权限
1. 添加机器人能力
在应用详情页的应用能力模块，点击添加应用能力，选择机器人选项卡并点击添加，完成机器人基础能力的开启，这是实现 OpenClaw 与飞书消息交互的核心步骤。
2. 开通核心权限
点击左侧权限管理，进入后点击开通权限，根据使用需求配置对应权限，核心权限分为五大类，标注了必选 / 建议选 / 可选，按需勾选即可：
基础能力（核心必配）
表格
| 权限 | 权限码 | 说明 |
|---|---|---|
| 读取群信息 | im:chat:readonly | 获取群组基础信息 |
| 发送消息 | im:message:send | 向飞书单聊 / 群组发送消息 |
| 接收群消息 | im:message.group_msg | 接收群内 @机器人的消息 |
| 接收私聊消息 | im:message.p2p_msg | 接收与机器人的私聊消息 |
云文档（Docs）
表格
| 权限 | 权限码 | 建议 |
|---|---|---|
| 查看文档 | docs:document:readonly | 必选，实现文档读取 |
| 编辑文档 | docs:document:write | 建议选，支持文档编辑 / 创建 |
| 查看文档权限 | docs:permission:readonly | 可选 |
| 修改文档权限 | docs:permission:write | 可选 |
多维表格（Bitable）
表格
| 权限 | 权限码 | 建议 |
|---|---|---|
| 查看多维表格 | bitable:app:readonly | 必选 |
| 编辑多维表格 | bitable:app | 建议选 |
| 查看记录 | bitable:table:readonly | 必选 |
| 编辑记录 | bitable:table:write | 建议选 |
云盘（Drive）
表格
| 权限 | 权限码 | 建议 |
|---|---|---|
| 查看云盘文件 | drive:drive:readonly | 建议选 |
| 下载文件 | drive:file:readonly | 建议选 |
| 上传文件 | drive:file:write | 可选 |
其他辅助权限
表格
| 权限 | 权限码 | 说明 |
|---|---|---|
| 查看用户 ID | contact:contact.base:readonly | 用于飞书内 @人功能，建议勾选 |
3. 权限配置小技巧
-
快速搜索：在添加权限页面的搜索框输入
docs:document drive:file im:message im:chat contact:contact，可一键筛选所有核心权限，避免遗漏； -
偷懒法：若仅用于与 Agent 协作，可直接勾选所有
im:message、docs:document开头的权限（慎用，适用于测试阶段）； -
最小权限法：若仅做基础测试，至少勾选
im:message、im:chat、im:message.group_msg、im:message.p2p_msg、docs:document:readonly这五个权限。
三、事件与回调配置
-
点击左侧事件与回调，进入事件配置，选择订阅方式为使用长连接接收事件，点击保存（该方式无需注册公网域名或配置加密策略，仅需通过官方 SDK 启动长连接即可，适合个人 / 小团队使用）；
-
点击添加事件，在事件列表中选择im.message.receive_v1（接收消息事件），点击保存，完成后飞书平台会在有消息交互时，将事件推送给 OpenClaw。
四、发布飞书应用
-
点击左侧版本管理与发布，点击创建版本；
-
填写版本信息：版本号建议设为
1.0.0，更新说明填写OpenClaw 初始版本发布，点击保存； -
点击申请发布，若为个人飞书账号，系统会自动审核通过；若为企业飞书账号，需等待企业管理员在后台审核，审核通过后应用正式生效。
五、配置 OpenClaw 中的飞书 Bot
完成飞书端的配置后，需在 OpenClaw 中完成飞书 Bot 的关联，提供两种方法，推荐方法 1，更高效且不易出错：
方法 1：通过.env 文件 + Coding Agent 配置（推荐）
-
找到 OpenClaw 的安装目录，打开其中的 **.env文件，将之前记录的飞书APP ID和APP SECRET** 写入文件对应位置；
-
打开 Coding Agent（如 Kimi Code、Claude Code、Codex 等），发送指令我已经将飞书 Bot 的 APP ID 和 APP SECRET 写入了.env 文件中，请帮我完成 OpenClaw 的飞书 bot 的配置，Agent 会在 1 分钟左右自动完成配置，全程无需手动操作。
方法 2：通过 OpenClaw onboard 命令配置
适用于 OpenClaw 2026.2.3 及以上版本，在终端运行命令：
plaintext
openclaw onboard --install-daemon
运行后会出现渠道选择列表，找到Feishu (Lark Open Platform)(plugin ·install) 并选择，按提示完成后续配置即可。
小提示：无论使用哪种方法，建议配置时全程打开 Coding Agent，遇到任何 bug 可直接将问题丢给 Agent，能快速定位并解决（如 Zod v4 语法兼容问题、插件配置失败等）。
六、添加机器人并验证连接
1. 将机器人添加至飞书单聊 / 群组
-
群组添加：进入飞书群组，点击右上角设置→群机器人→添加机器人，搜索你创建的机器人名称并添加；
-
私聊使用：在飞书顶部搜索框输入机器人名称，点击进入对话框即可，也可通过飞书开发者小助手的打开应用入口进入聊天。
2. 验证连接是否成功
-
在飞书与机器人的对话框中发送你好，若出现OpenClaw access not configured及配对码（Pairing code），说明配置已关联，仅需完成配对；
-
打开终端，运行配对命令：
plaintext
openclaw pairing approve feishu <配对码>
- 命令运行成功后，再次在飞书发送你好，若收到机器人的 AI 回复，说明 OpenClaw 与飞书已成功打通，可正常使用！
七、拓展使用场景与小技巧
成功对接后，给 OpenClaw 配置合适的权限，就能解锁超多飞书办公场景：
-
文档处理：丢入文章链接，让机器人完成翻译并生成格式化的飞书文档，直接发送至聊天窗口；
-
工作流管理：基于飞书云文档 / 多维表格，实现任务备忘、项目管理、进度跟踪等；
-
个性化交互：根据需求让机器人完成文本整理、内容创作、指令执行等操作，贴合个人 / 团队的办公习惯。
重要提醒：全程建议开启 Coding Agent，OpenClaw 飞书插件的部分小 bug 可通过 Agent 快速解决，避免因配置问题浪费时间。
打通飞书后的 OpenClaw，将 AI 的本地系统操控能力与飞书的办公生态完美结合，不管是个人提升办公效率，还是小团队搭建轻量化 AI 工作流，都能带来全新的体验，快去试试解锁更多个性化玩法吧！