龙虾养成记014 | 飞书插件踩坑记:原来有两个插件,功能差了一整条河

一个让我抓狂的问题

最近在测试 OpenClaw 的飞书集成功能，发现一个诡异的问题：

怎么都收不到文件！

无论是发图片、PDF，还是各种文档，飞书那边就是毫无反应。我反复检查配置、重新授权、甚至怀疑是网络问题，折腾了大半天。

直到今天，我终于搞清楚了——

原来 OpenClaw 接飞书，有两个完全不同的插件。

而我一直在用的，是功能受限的那个。

· · ·

两个插件，两条技术路线

OpenClaw 内置飞书插件

这是 OpenClaw 社区维护的飞书插件，从 2026.2 版本开始已经内置在 OpenClaw 里，不需要额外安装。

安装简单，一条命令就能配好：

代码bash

openclaw channels add # 选择 Feishu → 粘贴 App ID → 粘贴 App Secret

它的定位是：让 OpenClaw 能收发飞书消息，做个聊天入口。

问题是：它的能力边界很清晰——只管聊天，不管干活。

飞书官方 OpenClaw 插件

这是飞书团队自己开发的官方插件，通过 OAuth 授权，让 AI 能以”你”的身份操作飞书。

安装方式完全不同：

代码bash

npx -y @larksuite/openclaw-lark install

安装过程中需要扫码授权，让 AI 获得以你身份操作飞书的权限。

关键差异：它不只是聊天机器人，而是你的数字分身。

· · ·

核心能力对比

简单来说：

• ●内置插件
  
   = 能聊天，但干不了飞书里的活
• ●官方插件
  
   = 能聊天 + 能干活（写文档、建表、约会议、管任务）

· · ·

我踩的坑

问题起因

我最开始用的是 OpenClaw 内置插件，配置确实简单，几行命令就跑起来了。聊天没问题，但发文件就是收不到。

我还以为是自己配置错了，去飞书开放平台检查权限：

• ●
  
  ✅ 消息权限开了
• ●
  
  ✅ 文件权限申请了
• ●
  
  ✅ 事件订阅配了

全部正确，但文件就是收不到。

真相大白

后来查资料才发现，内置插件的设计目标就是”聊天入口”，文件处理能力本身就有限制。

想收文件？得用飞书官方插件。

切换到官方插件

按照飞书官方文档，重新安装：

代码bash

npx -y @larksuite/openclaw-lark install

扫码授权后，机器人不仅能收文件了，还能：

• ●
  
  帮我写飞书文档
• ●
  
  操作多维表格
• ●
  
  查日历、约会议
• ●
  
  管理任务清单

这才是我想要的”数字分身”。

· · ·

避坑指南

如果你也在做 OpenClaw + 飞书的集成，记住这几点：

1. 先想清楚你要什么

• ●
  
  只是当聊天入口，让 AI 回答问题？ → 内置插件够用
• ●
  
  需要 AI 帮你在飞书里干活？ → 必须用官方插件

2. 安装方式完全不同

3. 两者不能同时用

安装官方插件时，会自动禁用内置插件。

如果两个都装了，会报 duplicate plugin id 错误。遇到这种情况：

代码bash

rm -rf ~/.openclaw/extensions/feishu openclaw gateway restart

4. 官方插件需要额外权限

安装官方插件后，要在飞书开放平台补充权限配置，包括文档、多维表格、日历、任务等。

飞书文档里有完整的权限 JSON，一键导入即可。

· · ·

小结

这次踩坑让我学到一件事：

“能聊天”和”能干活”之间，隔着一个官方插件。

OpenClaw 内置插件的设计目标是”连接”，让你能在飞书里和 AI 对话。

飞书官方插件的设计目标是”赋能”，让 AI 能以你的身份操作飞书，真正成为数字分身。

两者定位不同，能力边界也完全不同。下次遇到”某个功能不行”的问题，先别急着怀疑配置——看看是不是选错了插件。

· · ·

💡 龙虾养成记 是一个专注 AI 落地实战的系列栏目，记录真实的踩坑与解决方案。如果你也在做 AI 相关的技术集成，欢迎关注交流！

· · ·

参考资源：

• ●
  
  [飞书官方插件完整教程](https://www.feishu.cn/content/article/7613711414611463386)
• ●
  
  [OpenClaw 飞书配置指南 (GitHub)](https://github.com/AlexAnys/openclaw-feishu)

— 全文完 —

如果对你有帮助，欢迎点个 在看 👀 或 转发 给朋友 🙌