夜雨聆风
大家好，我是寂寞的熊猫。
飞书CLI开源了。200+命令、19个Agent Skills、覆盖11个业务域、三层调用架构，飞书终于开窍了。
GitHub地址：https://github.com/larksuite/cli[1]
但如果你跟我一样，OpenClaw的飞书官方插件已经用了一段时间，你大概率会有一个困惑：
我又装一个飞书CLI，到底是升级，还是重复？
这个问题值得认真说清楚，因为两者的功能确实有大量重叠，但定位差异也确实存在。盲目都装，只会让系统更复杂；只装一个，可能错过真正有用的能力。
省流版结论：
- 两者有重叠但不是替代关系——OpenClaw飞书插件是"对话入口+体验层"，飞书CLI是"确定性执行工具+能力兜底"。
- OpenClaw插件覆盖的高频场景（消息、文档、日历、多维表格），日常够用，体验也更流畅。
- 飞书CLI的不可替代价值在于：邮箱、知识库、会议纪要、通讯录、2500+长尾API覆盖，以及schema自省和dry-run预览。
- 最佳实践是组合使用：OpenClaw做入口和编排，飞书CLI做能力兜底。用Agent Skills机制把CLI装进OpenClaw的技能目录就行。
- 如果你只用Claude Code不用OpenClaw，飞书CLI是必须装的，这是目前让Claude Code操控飞书的唯一官方方案。
先搞清楚：各自是什么
在讨论"该装哪个"之前，先把两个工具的定位说清楚。
OpenClaw飞书官方插件
这个插件是飞书开放平台团队维护的，作为OpenClaw的一个Channel插件运行。它的核心逻辑是：通过WebSocket连接飞书机器人，把飞书聊天窗口变成AI的交互界面。
它擅长的：
- 在飞书聊天里直接跟AI对话，支持流式回复和交互卡片
- 群组权限控制（谁可以触发AI、什么关键词触发）
- 消息、文档、多维表格、日历、任务的读写操作
本质上，它是一个"对话式体验层"——你跟AI说话，AI在飞书里帮你把事办了。
飞书CLI（lark-cli）
这是飞书开放平台官方开源的命令行工具，覆盖11个业务域、200+命令，内置19个Agent Skills。
它的架构分三层：
- Shortcuts（
+前缀）：高频操作的高层封装，有智能默认值和表格输出 - API Commands：100+命令跟飞书平台端点1:1映射
- Raw API：覆盖飞书开放平台2500+个API，理论上什么都能调
本质上，它是一个"确定性执行工具"——你给命令，它精确执行，返回结构化结果。
一句话区别
OpenClaw飞书插件像是一个能听懂人话的飞书助手，你跟它聊天，它帮你办事。
飞书CLI像是一把万能钥匙，覆盖飞书几乎所有能力，精确、可审计、可脚本化。
重叠区：都能做，但做得不一样
先说不舒服的事实：两者的功能重叠相当大。
| 能力 | OpenClaw飞书插件 | 飞书CLI |
|---|---|---|
| 发送/回复消息 | 支持，带交互卡片 | 支持，有dry-run预览 |
| 文档读写 | 支持 | 支持，Markdown格式 |
| 多维表格CRUD | 支持，含批量操作 | 支持，含schema自省 |
| 日历管理 | 支持 | 支持，含忙闲查询 |
| 电子表格 | 支持 | 支持，含导出功能 |
| 任务管理 | 支持 | 支持，含子任务和提醒 |
在这个重叠区里，日常高频操作（查日程、发消息、读文档、更新表格）用哪个都行。如果你只用这些功能，OpenClaw插件体验更流畅——因为对话式交互天然比命令行更直观。
互补区：各自不可替代的部分
真正的差异在重叠区之外。
飞书CLI独有的能力
这些是OpenClaw飞书插件目前没有覆盖的：
邮箱（lark-mail）：浏览、搜索、阅读邮件，发送、回复、转发，监听新邮件。这个能力在企业场景里价值极高——让AI帮你处理收件箱、自动回复简历、批量发送定制邮件。
知识库（lark-wiki）：创建管理知识空间、节点和文档。让AI能遍历和检索企业知识库，对构建RAG工作流很有价值。
会议纪要（lark-vc / lark-minutes）：搜索会议记录、获取妙记的摘要和待办。开完会直接让AI从妙记里提待办、排优先级。
通讯录（lark-contact）：按姓名、邮箱、手机号搜索同事。批量找人、查组织架构。
API探索器（lark-openapi-explorer）：从官方文档探索底层API。遇到CLI没封装的接口，可以先用探索器确认参数和权限，再用Raw API调用。
自定义Skill创建（lark-skill-maker）：把高频操作沉淀成新的SKILL.md，方便复用。
实时事件订阅（lark-event）：WebSocket订阅飞书实时事件，支持正则路由。可以做成"新消息到达自动处理"的工作流。
白板/图表渲染（lark-whiteboard）：用DSL渲染图表，适合可视化场景。
两个预置工作流：
lark-workflow-meeting-summary：会议纪要聚合与结构化报告lark-workflow-standup-report：议程与待办汇总报告
schema自省：调用之前可以先用 lark-cli schema <API> 查看参数结构、请求体和所需权限。这意味着AI在调用失败时可以自己查"说明书"并修正。
dry-run预览：所有可能产生副作用的命令都支持先预览再执行。这对安全性至关重要。
OpenClaw飞书插件独有的优势
反过来，OpenClaw飞书插件也有一些CLI没有的能力：
交互卡片：AI的回复可以用飞书卡片展示，比纯文本丰富得多。
流式回复：AI一边思考一边输出，用户不需要干等。思考过程以Markdown引用块展示在卡片顶部。
群组治理：可以设置触发规则（@提及+特定关键词）、发件人白名单、群组级配置。防止AI在群里"乱说话"。
WebSocket消息流：作为Channel插件，天然接入OpenClaw的消息路由系统，支持多Agent协同。
组合实践：怎么搭配着用
弄清楚了重叠和互补，接下来的问题就是：怎么组合？
推荐架构：OpenClaw做入口，飞书CLI做工具。
具体来说：
- 日常对话式操作走OpenClaw飞书插件（查日程、发消息、读文档）
- 需要CLI独有能力时（邮箱、知识库、会议纪要等），OpenClaw调用飞书CLI的Skills来执行
- 所有写入类操作走CLI的dry-run预览，增加一层安全保障
安装方法
如果你已经在用OpenClaw飞书插件，只需要额外装飞书CLI和Skills：
# 1. 安装飞书CLInpm install -g @larksuite/cli# 2. 把飞书CLI的Skills安装到OpenClawnpx skills add larksuite/cli --all -y然后确保 lark-cli 在OpenClaw的执行环境里可用就行。如果你启用了Docker沙箱，需要把 lark-cli 也装进沙箱镜像。
安装完成后记得重启OpenClaw。
一个实际的工作流
假设你刚开完一个项目会，想让AI帮你处理会后事务：
- OpenClaw入口：你在飞书群里@机器人，"把今天项目会的纪要整理一下，待办写入多维表格，给相关人员发通知"
- 飞书CLI执行：
lark-cli vc搜索会议记录lark-cli minutes获取妙记摘要和待办lark-cli base把待办写入多维表格（先dry-run预览）lark-cli im给相关同事发送通知消息- OpenClaw返回：用交互卡片展示处理结果，包含文档链接和任务列表
这个流程里，OpenClaw负责理解你的意图和编排步骤，飞书CLI负责精确执行每个操作。两者各司其职。
如果你只用Claude Code
那飞书CLI就是必须装的——这是目前让Claude Code直接操控飞书的唯一官方方案。
安装步骤也很简单：
# 安装CLInpm install -g @larksuite/cli# 安装Skills（关键步骤，别漏了）npx skills add larksuite/cli --all -y -g# 配置（会给你一个二维码链接）lark-cli config init# 登录授权lark-cli auth login --recommend安装完重启Claude Code，就可以直接用自然语言操控飞书了。
安全提醒
不管用哪个工具，安全这一条绕不过去。
两者都在文档里明确提示了三个核心风险：
- 提示词注入：恶意内容可能劫持AI的行为，滥用飞书权限
- 过度授权：为图方便一次授予所有权限，扩大了误操作的影响范围
- 不可逆操作：消息发出去了收不回来，文档改了回不去
对应的实践建议：
- 最小权限原则：用
auth login --scope精确授权，只开通你需要的域 - 私聊优先：建议把对接机器人用于私聊，不要拉入多人群
- 先预览再执行：所有写入操作走dry-run预览，确认无误后再执行
- 定期审计：运行
openclaw security audit检查配置
总结
飞书CLI和OpenClaw飞书插件不是"二选一"的关系，而是"互补组合"的关系。
简单记：
- OpenClaw飞书插件 = 对话入口 + 体验层（你跟AI聊天的地方）
- 飞书CLI = 能力兜底 + 精确执行（AI帮你干活的工具箱）
- 两者组合 = 覆盖最全、体验最好、安全性最高
如果你已经在用OpenClaw飞书插件，我建议装上飞书CLI的Skills，补上邮箱、知识库、会议纪要这些高频但插件还没覆盖的能力。
如果你只用Claude Code，飞书CLI直接装就对了，这是目前操控飞书的最佳方案。
飞书这一步走得很漂亮——从OpenClaw官方插件到CLI开源，它在持续降低AI接入飞书的门槛。对用户来说，工具多了不是问题，问题是你能不能搞清楚每个工具该用在什么地方。
如果对AI个人提效，以及副业感兴趣，而不只是围观，也推荐加入 IDO 老徐 的知识星球：AI 落地实战 · DeepSeek · OpenClaw。
里面会持续分享 OpenClaw 相关内容、AI 工作流搭建、商业化落地和各种实战避坑经验。
