OpenClaw 飞书官方插件上线：从“会聊天”到“真干活”的完整指南

“

你有没有这种感觉：AI 明明很聪明，但一到实际工作就得你来回搬运资料？

今天这篇文章，带你把 OpenClaw 在飞书里真正跑起来——能读、能写、能查、能执行，让它从“聊天搭子”变成“工作搭子”。

先说结论：这个插件到底值不值得装？

一句话：值得，而且越早装越省时间。

装完官方插件并授权后，OpenClaw 可以直接在飞书里完成实际动作：

• 读群消息、回消息、搜消息；
• 创建/修改文档；
• 管理多维表格数据；
• 查日历、建日程、看忙闲；
• 管理任务与待办。

也就是说，你不再是“复制粘贴中间人”，而是直接给目标。

一、完整功能一览（收藏）

💬 消息能力

• 读取群聊/单聊历史
• 话题回复
• 发送/回复消息
• 搜索消息
• 下载图片/文件

📄 文档能力

• 创建飞书云文档
• 更新文档内容
• 读取文档信息

📊 多维表格能力

• 创建/管理多维表格与数据表
• 字段管理
• 记录增删改查
• 批量处理与筛选

📅 日历能力

• 日历与日程管理
• 新建/修改/删除/搜索日程
• 参会人管理
• 忙闲查询

✅ 任务能力

• 任务创建/查询/更新/完成
• 清单管理
• 子任务
• 评论协作

二、安装前 3 个前提（别跳过）

1）OpenClaw 版本符合要求

• Linux / MacOS：2026.2.26 及以上
• Windows：2026.3.2 及以上

openclaw -v

升级：

npm install -g openclaw

2）飞书开放平台应用已创建

需要完成：

• 创建企业自建应用
• 添加机器人能力
• 配置并申请权限
• 创建版本并发布
• 拿到 App ID 与 App Secret

入口：https://open.feishu.cn/app?lang=zh-CN

3）准备好做一次完整授权

没授权就无法“代你操作”。建议一次性完成批量授权，减少后续打断。

三、安装步骤（可直接照抄）

Mac / Linux

npm config set registry https://registry.npmjs.org
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz
feishu-plugin-onboard install

Windows（cmd）

npm config set registry https://registry.npmjs.org
curl -o "%TEMP%\feishu.tgz" https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/c53145d7b9eb0e29f4e07bf051231230_XjCy46mAFI.tgz
npm install -g "%TEMP%\feishu.tgz"
del "%TEMP%\feishu.tgz"
feishu-plugin-onboard install

“

小提醒：如果你之前装过其他飞书插件，官方插件安装时通常会自动禁用旧插件；升级后建议再检查一次，避免冲突。

四、安装后怎么验收？（30 秒自检）

启动：

openclaw gateway run

检查插件：

openclaw plugins list

理想状态：

• feishu-openclaw-plugin = loaded
• 旧 feishu 插件 = disabled

聊天里再执行：

/feishu start

能返回版本信息，基本就通了。

五、配对与授权（关键中的关键）

1. 在飞书里给机器人发消息，拿配对码（有效期通常 5 分钟）
2. 终端执行：

openclaw pairing approve feishu <配对码> --notify

1. 完成授权卡片
2. 或在对话中执行：/feishu auth 批量授权

六、常用维护命令（建议收藏）

更新插件

feishu-plugin-onboard update

诊断问题

/feishu doctor

或：

feishu-plugin-onboard doctor
feishu-plugin-onboard doctor --fix

打印诊断信息（反馈问题用）

feishu-plugin-onboard info
feishu-plugin-onboard info --all

七、群聊回复模式怎么选？

模式 1（推荐）

只有 @ 机器人 才回复，稳妥不刷屏。

openclaw config set channels.feishu.requireMention true --json

模式 2（谨慎）

不用 @ 也能回复，适合小群试验，不建议直接大群开。

openclaw config set channels.feishu.requireMention open --json

模式 3（高级）

默认一个规则，指定群单独配置：

openclaw config set channels.feishu.groups.oc_xxxxx.requireMention true --json

先看当前配置：

openclaw config get channels.feishu

八、常见问题速查（FAQ）

Q1：报 cannot find module xxx？

通常是依赖没装完整。进入插件目录执行：

npm install

Q2：想开流式输出？

openclaw config set channels.feishu.streaming true

关闭：

openclaw config set channels.feishu.streaming false

Q3：升级后工具调不起来？

检查 openclaw.json 是否放开工具权限，例如：

{
"tools": {
"profile": "full",
"sessions": { "visibility": "all" }
  }
}

Q4：和旧插件/MCP 冲突？

原则：保留官方插件，禁用/移除旧飞书插件或旧 MCP。

九、你可以马上试的 3 个实战指令

1. “帮我把这个群今天的待办提取成清单并生成文档。”
2. “从这周日历里找空档，给我建议 3 个可开会时间。”
3. “把这个项目进展同步到多维表格，并给相关人发通知。”

这 3 个任务跑通，你会明显感受到插件的效率提升。

十、结尾：别再让 AI 只停留在“会聊”

真正的效率提升，不是多一个聊天窗口， 而是让 AI 在你真实工作流里“拿数据、做动作、出结果”。

如果你还没装官方插件，这周就把它跑起来。
先选一个重复性最高的任务交给它，你会很快看到时间红利。