乐于分享
好东西不私藏

飞书 CLI 开源深度解析:当办公软件被压缩成一行命令,AI Agent 时代的"操作系统"已经到来

飞书 CLI 开源深度解析:当办公软件被压缩成一行命令,AI Agent 时代的"操作系统"已经到来

飞书 CLI 开源深度解析:当办公软件被压缩成一行命令,AI Agent 时代的”操作系统”已经到来

这不是一次普通的版本更新,这是一场关于软件交互范式的静默革命。GUI 的时代正在被重新定义,而新的用户,叫 Agent。


写在前面:一个周末早晨的”地震”

2026 年 3 月 28 日,一个普通的周末早晨。

当我像往常一样打开手机刷资讯时,一条消息让我从床上弹了起来——飞书官方开源了 CLI 工具

GitHub 地址:https://github.com/larksuite/cli

这不是一个普通的开发者工具发布。在过去,企业级办公软件的开源动作,多半是那种”文档不全、配置复杂”的开发者玩具。但这一次,完全不一样。

飞书这次开源的,是一个用 Go 语言编写、MIT 协议、内置 19 个 AI Skill、覆盖 2500+ 个 API的命令行工具。装上它之后,你的 AI Agent(比如 Claude Code、Cursor、Codex)可以直接操作飞书——发消息、查日历、写文档、建多维表格、发邮件、管任务、搜知识库……你跟 AI 说一句话,它自己去飞书里把事情办了。

> “如果这个世界,所有的软件都能跟飞书一样 CLI 化。如果所有你日常使用的软件,都有一层 CLI,都可以被 AI 直接调用。那时候,我们心中所想的科幻世界里的那个超级 AI 助理,就真的即将快被实现了。”

今天,我们就来深度拆解这次开源事件背后的技术逻辑、产品哲学,以及它对整个 AI Agent 生态的深远影响。

这篇文章,我计划用一万字的篇幅,带你完整看懂:
  • 飞书 CLI 到底是什么?它的技术架构有多强?
  • 为什么说”GUI → CLI”是软件交互范式的历史性逆转?
  • 实战演示:用 Claude Code+ 飞书 CLI,我 5 分钟干了哪些”不可能的事”?
  • 企业级应用:从个人效率到团队协作,飞书 CLI 能带来什么?
  • 未来展望:当所有软件都 CLI 化,我们的工作方式将如何被重塑?

如果你也是 AI Agent 的深度用户,或者你所在的企业正在探索 AI 落地的可能性,这篇文章值得你花 20 分钟认真读完。


第一章:什么是飞书 CLI?——把整个办公套件”降维”成命令行

1.1 CLI 与 GUI:两种截然不同的交互哲学

在深入技术细节之前,我们先做一个基础科普。如果你已经是技术老炮,可以直接跳过这一节。

GUI,Graphical User Interface,图形用户界面。

说人话就是——你现在看到的一切。你手机上的微信界面,你电脑上的飞书窗口,你每天点来点去的那些按钮、菜单、对话框,全部都是 GUI。

GUI 的逻辑是:把所有功能变成你看得见摸得着的东西。你不需要记任何命令,看到按钮就点,看到输入框就填。简单直观,傻瓜式操作。GUI 是为人类设计的。因为人类是视觉动物,我们需要看到东西才能理解东西。

CLI,Command Line Interface,命令行界面。

就是那种黑乎乎的屏幕,你敲一行字,电脑给你吐一行结果的东西。很多人一看到这个界面就头大,觉得这玩意是程序员才用的。

以前确实是。但是现在,大人,时代变了。

CLI 有一个 GUI 永远比不了的优势:它天然适合被 AI 操控。在这个年头,AI 最核心的交互方式,依然是文字,是指令,是一句一句的代码命令。而 CLI,恰好就是用命令来操作一切的。

1.2 飞书 CLI 的核心数据:不只是”又一个命令行工具”

让我们先看一组硬核数据:

指标
数据
说明
开发语言
Go
高性能、跨平台
开源协议
MIT
完全免费商用
覆盖 API 数量
2500+
飞书开放平台全量接口
内置命令
200+
覆盖 11 个业务域
内置 AI Skill
19 个
即插即用
GitHub Stars
451(开源初期)
社区刚刚起步
最新版本
v1.0.0
2026 年 3 月 28 日发布

这组数据的含金量在于:这不是一个”简化版”的工具,而是把飞书的全部核心能力完整地暴露给了命令行。

覆盖的业务域包括:

  • lark-im
    :消息和群聊管理
  • lark-doc
    :文档创建和编辑
  • lark-drive
    :云空间文件管理
  • lark-calendar
    :日历和会议管理
  • lark-mail
    :邮件处理(重点增强,补齐了完整的增删改查能力)
  • lark-sheets
    :电子表格操作
  • lark-base
    :多维表格管理
  • lark-task
    :任务管理
  • lark-wiki
    :知识库搜索
  • lark-contact
    :通讯录查询
  • lark-vc / lark-minutes
    :会议纪要处理
  • lark-event
    :实时事件订阅
  • lark-search
    :跨业务域搜索

1.3 三层命令体系:为 AI 设计的巧妙架构

飞书 CLI 的架构设计非常值得学习。它采用了三层命令体系

第一层:Shortcuts(快捷命令)

带 + 前缀,比如+agenda查看今日日程、+messages-send 发送消息。这一层带智能默认值,对人类和 AI 都极其友好。日常使用,这一层就够了。

第二层:API Commands

基于 OpenAPI 元数据自动生成,覆盖 100+ 常用接口。比如lark-cli im messages-send 发送消息。这一层适合需要精细控制的场景。

第三层:Raw API

可以直接调用飞书开放平台的任意端点,覆盖全部 2500+ 个 API。这一层给了开发者完全的灵活性。

这种分层设计的好处是:既照顾了人类的操作习惯(Shortcuts 足够简单),也考虑了 AI 的可解析性(API 命令足够结构化),还保留了高级用户的自由度(Raw API)


第二章:为什么说这是”AI 原生”的设计?

2.1 不是”让 AI 能用”,而是”为 AI 而设计”

很多产品在接入 AI 时,思路是:先有人类用的功能,然后给 AI 开个 API 接口。这是”让 AI 能用”。

飞书 CLI 的思路完全不同:从一开始,它就把 AI 当作第一用户来设计

体现在哪里?我们来看几个关键设计:

1. 出错引导——AI 能自己修复错误

一般的 API 报错信息是这样的:404 Not Found500 Internal Server Error。AI 看到这种信息,只能干瞪眼。

飞书 CLI 的报错信息是这样的:“哪个参数出了问题、具体错在哪里、下一步应该执行什么命令来修复”。AI 拿到这些信息,可以自主重试和修正。这个细节值得所有做 AI 工具的公司学习。

2. 权限自动补授——AI 能自己申请权限

当 AI 调用某个 API 但缺少权限时,CLI 会自动引导完成授权,或者生成一个授权链接让 AI 转发给用户。整个过程不需要用户手动去后台翻权限配置。

3. Dry-run 预览——AI 可以先”预演”再执行

所有可能产生副作用的命令,都支持 --dry-run 参数。AI 可以先执行预览模式,确认结果符合预期后,再真正执行。这在批量操作场景下极其重要。

4. 输出格式灵活——AI 用 JSON,人类用 Table

支持 JSON、Table、CSV、NDJSON 四种输出格式。AI 解析用 JSON,人类阅读用 Table。同一个命令,两种视角。

5. Schema 自省——AI 能自己查 API 文档

AI 在调用任何 API 之前,可以先查询这个 API 的参数结构和所需权限。这意味着 AI 可以动态学习,而不是硬编码。

2.2 两种身份认证:用户身份 vs 应用身份

飞书 CLI 同时支持两种认证方式:

用户身份:Agent 以你的名义操作,能访问你个人的日历、私信、收件箱。适合个人场景。比如让 AI 帮你查今天的日程、帮你给同事发消息。 应用身份:Agent 以一个飞书应用的身份运行,适合企业级 Agent 和自动化工作流。比如让 AI 定期扫描多维表格、自动给缺失字段的负责人发消息。

还有一个细节:不授权也能用。Agent 仍然可以执行发消息、创建文档这些操作,只是无法访问你的个人数据。这个设计降低了上手门槛,让用户可以”先用起来再说”。


第三章:实战演示——5 分钟,让 Claude Code 接管你的飞书

理论说完了,我们来点实际的。下面是我亲测的完整流程,每一步都是真实的。

3.1 安装:三步搞定,全程不需要手动配置

第一步:安装 CLI

在终端里执行:

npm install -g @larksuite/cli
第二步:初始化配置
lark-cli config init

终端会弹出一个二维码。打开手机飞书扫码,在授权页面一键开通所有常用权限——多维表格、日历、通讯录、文档、消息、邮箱、电子表格、任务、视频会议。

第三步:安装 AI Skill

如果你在用 Claude Code、Cursor、Codex 等 AI 工具,还需要安装 Skills,让 AI 知道怎么调用这些命令:

npx skills add larksuite/cli -y -g

然后,重启你的 AI 工具。注意,不是热重载,是彻底重启。

整个安装过程,你不需要去飞书开放平台创建应用、不需要手动申请权限、不需要复制粘贴任何 AppID 和 AppSecret。全程就是:扫码 → 授权 → 完成。

3.2 实战一:给全公司同事群发个性化消息

装好之后,我做的第一件事:用 Claude Code 给公司所有同事发一条消息,庆祝飞书 CLI 上线。

我对 Claude Code 说:

> “帮我给我的通讯录里的所有内部联系人,个性化的发一句话,大概意思就是:这是今天飞书 CLI 上线以后,我用 Claude Code 操控飞书给大家发的第一条消息,以后飞书的使用方式就真的变了,感受一下 Agent 时代的魅力吧,周末愉快!然后附上飞书 CLI 的 Github 链接。”

Claude Code 开始工作:

  • 先用lark-cli contact list 获取通讯录
  • 识别出 25 个联系人,排除我自己,剩下 24 个
  • 逐个调用lark-cli im messages-send 发送消息

整个过程大约 1 分钟。10 秒后,就有同事在群里发截图说收到了。

这就是 Agent 的力量——以前这种事,要么手动一个个发,要么写脚本调用 API。现在,说一句话就行。

3.3 实战二:用 AI 扫描多维表格,自动补全缺失数据

我们团队用飞书多维表格做项目管理,但有个痛点:数据量太大,很多字段需要手动填写,偶尔会漏掉。导致后续的自动化和报表出错。

于是我对 Claude Code 说:

> “帮我扫描’项目管理’这个多维表格,找出所有缺失字段的记录。然后每周五下午给对应负责的同事发消息,提醒他们补充。”

Claude Code 的工作流: 1. 用lark-cli base records list 获取多维表格所有记录 2. 逐条检查必填字段是否为空 3. 找到缺失的记录后,用lark-cli im messages-send 给负责人发提醒

然后我把这个流程设置成定时任务——每周五自动运行。从此,再也没有漏填数据的情况了。

3.4 实战三:自动生成每日 AI 资讯日报

我一直在做一个给公司内部看的 AI 资讯监控。之前需要手动整理,很耗时。

现在我对 Claude Code 说:

> “帮我做一个飞书日报,每天早上 8 点给群’AI 资讯群’发一份昨天监控的所有 AI 资讯的汇总日报。”

Claude Code 自己完成了:

  • 写了一个爬虫脚本,定时抓取 AI 资讯源
  • lark-cli im messages-send 发送到群聊
  • lark-cli doc create 创建备份文档

整个流程从提出需求到部署上线,不到 10 分钟。

3.5 实战四:批量处理邮箱里的简历

还有一个场景:HR 部门每天收到大量简历邮件,需要人工筛选和汇总。

我对 Claude Code 说:

> “帮我汇总邮箱里这周收到的所有简历,提取姓名、职位、公司、技能标签,生成一个多维表格。”

Claude Code: 1. 用lark-cli mail list 获取邮件列表 2. 用lark-cli mail read 读取每封邮件的正文和附件 3. 用 AI 分析简历内容,提取关键信息 4. 用lark-cli base records create 写入多维表格

几分钟后,一份结构化的候选人库就建好了。

3.6 小结:从”手动操作”到”一句话的事”

这四个实战案例,覆盖了消息、文档、多维表格、邮件四大业务域。以前做这些事,要么需要手动操作,要么需要写代码调用 API。现在,只需要对 AI 说一句话。

这不是”AI 辅助办公”,这是AI 直接操作办公系统


第四章:技术深度解析——飞书 CLI 是如何工作的?

4.1 技术栈:Go + MIT 协议

飞书 CLI 用 Go 语言编写。Go 的优势很明显:静态编译、跨平台、高性能、并发能力强。对于命令行工具来说,Go 是理想的选择。

MIT 协议意味着什么?完全免费商用,可以任意修改和二次开发。企业可以基于它构建自己的内部工具链,不用担心许可证问题。

4.2 与飞书开放平台的关系

飞书 CLI 本质上是对飞书开放平台 API 的封装,但它做了三件重要的事情:

第一,命令生成自动化。基于 OpenAPI 元数据自动生成 API 命令,确保与开放平台的同步性。开放平台新增 API,CLI 自动就能用。 第二,认证流程简化。把 OAuth 2.0 的复杂流程封装成config init 一条命令,扫码即完成。 第三,错误处理增强。在 API 返回的错误信息基础上,增加了”下一步应该怎么做”的提示,这是为 AI 设计的核心优化。

4.3 与社区项目的关系

在飞书官方 CLI 发布之前,社区已经有了一些优秀的开源项目,比如feishu-mcp(Model Context Protocol 服务器)。

feishu-mcp 发布于 2026 年 3 月 19 日,比官方 CLI 早了一周多。它支持文档处理、任务管理、用户信息查询,也是基于 MCP 协议让 AI 编码工具能够操作飞书。

官方 CLI 的发布,不是对社区项目的替代,而是对生态的补全。官方版本的优势在于:覆盖更全(2500+ API vs 21 个工具)、稳定性有保障、与飞书产品同步更新

4.4 与 OpenClaw 的集成

如果你是 OpenClaw 用户,飞书官方后续会发布一个内置全部 CLI 能力的”飞书官方 OpenClaw 插件”。升级之后不需要单独安装 CLI,现有的飞书 OpenClaw 官方插件底层就是基于这套 CLI 构建的。

OpenClaw 是一个让 AI 助手接入各种平台的工具,目前已经支持飞书。openclaw-feishu 插件基于飞书 WebSocket 长连接,无需公网服务器,支持私聊和群聊、图片与文件收发。


第五章:从 GUI 到 CLI——软件交互范式的历史性逆转

5.1 计算机交互的三次革命

回顾计算机发展史,交互范式经历了三次大的变革:

第一次:命令行界面(CLI)时代。最早的电脑就是命令行的,用户需要记住命令、精确输入。只有专业人士才能用。 第二次:图形用户界面(GUI)时代。Windows 和 Mac 的出现,让普通人也能用上电脑。看到按钮就点,看到菜单就选。大众化、民主化。 第三次:对话式交互时代?我们正在经历的。Siri、小爱同学、ChatGPT,用自然语言对话来完成任务。

但现在,我们看到了一个新的趋势:GUI → CLI 的回归

不是倒退,而是螺旋式上升。新的 CLI,不是给人用的,是给 AI 用的。

5.2 为什么 AI 需要 CLI?

AI 的核心交互方式是文字和指令。GUI 是为视觉系统设计的,而 AI 没有视觉系统(或者说,视觉不是它的主要感知通道)。

AI 不需要看到按钮。AI 不需要花里胡哨的动画。AI 需要的是:你给我一个接口,告诉我能做什么,我来调用。一行命令,一个功能

CLI 天然具备这样的特性:

  • 确定性
    :输入什么命令,得到什么输出,是可预测的
  • 可组合性
    :命令可以组合成更复杂的工作流
  • 可编程性
    :AI 可以生成命令、执行命令、处理结果
  • 可解析性
    :输出是结构化文本,AI 可以直接理解

5.3 传统 SaaS 的困境:DAU vs 真实价值

飞书这次迈出的步子,其实有点”狠”。

很多传统产品会看所谓的 DAU(日活跃用户)、停留时长这些指标。这些指标的前提是:用户要打开你的 GUI 产品才算。

但是当你把 CLI 开源出来之后,所有的 Agent 都可以通过命令行来直接调用你。用户有些时候就不需要打开飞书了。传统口径上的日活肯定会掉,但真正的对用户的价值,却反而上升了

一个效率工具,就应该为了用户的效率去服务。用户不打开你的界面,不代表你没在创造价值。飞书团队想清楚了这一点。

5.4 未来的软件:两种形态

> “未来,所有的产品,都将有两种形态。GUI,面向普通用户。CLI,面向开发者和 AI。”

这是飞书 CLI 开源事件带给行业的最大启示。

未来,当你使用一个软件时,你可以选择:

  • 打开它的 GUI,用鼠标点来点去
  • 或者,让你的 AI 去调用它的 CLI,用命令完成任务

这不仅仅是技术上的选择,更是产品哲学的根本转变


第六章:企业级应用——飞书 CLI 能带来什么?

6.1 对个人开发者:效率提升 80%+

对于个人开发者来说,飞书 CLI 的价值在于:

  • 快速原型
    :想验证一个想法,不需要写完整的 API 调用代码,直接用 CLI 命令
  • 脚本化操作
    :把重复性操作写成脚本,定时执行
  • AI 工作流
    :把 AI 工具(Claude Code 等)与飞书打通,实现自动化

根据测评,使用飞书 CLI 后,开发效率提升约 80%。

6.2 对企业:降本增效的新范式

对于企业用户来说,飞书 CLI 的价值更加深远:

1. DevOps 自动化

在 CI/CD 流程中集成飞书 CLI,自动发送部署成功/失败通知到飞书群。不需要写复杂的 Webhook 接入代码,直接调用 CLI 命令。

2. 批量数据处理

导出部门考勤数据、批量创建任务、自动生成周报文档……这些原本需要手动操作或定制开发的任务,现在可以用 CLI 脚本完成。

3. AI Agent 融入企业协作

这是最核心的价值。让 AI 助手真正参与企业协作流程——不只是回答问题,而是直接操作飞书完成任务。

比如:

  • AI 自动扫描多维表格,发现异常数据时给负责人发消息
  • AI 定期整理邮件,把重要信息汇总到文档
  • AI 根据日历安排,自动创建会议纪要文档

6.3 与竞品的对比:AI 原生是最大差异

特性
Lark CLI
飞书 OpenAPI
钉钉开放平台
企业微信 API
易用性
⭐⭐⭐⭐⭐
⭐⭐⭐
⭐⭐⭐⭐
⭐⭐⭐
AI Agent 支持
⭐⭐⭐⭐⭐
⭐⭐
⭐⭐⭐
⭐⭐
功能覆盖
⭐⭐⭐⭐⭐
⭐⭐⭐⭐⭐
⭐⭐⭐⭐
⭐⭐⭐⭐
社区活跃度
⭐⭐
⭐⭐⭐⭐
⭐⭐⭐⭐
⭐⭐⭐⭐

核心差异在于:Lark CLI 从底层就考虑 AI Agent 的使用场景,而其他工具更多是”人类开发者工具”,AI 使用需要额外封装


第七章:飞书生态的野望——Agent 基建平台

7.1 从 OpenClaw 开始,飞书一直在布局

这不是飞书第一次在 AI Agent 领域发力。

早在 2026 年 1 月,OpenClaw 项目就已经支持飞书接入。openclaw-feishu 插件让 AI 助手能够接入飞书,无需公网服务器,支持私聊和群聊。

现在,官方 CLI 的发布,把能力从”接入”升级到了”操作”。AI 不仅可以”听”飞书里的消息,还可以”说”和”做”。

> “从 OpenClaw 开始,飞书看来誓死要把 Agent 基建平台这个心智焊在脸上了。”

7.2 飞书 CLI 在飞书低代码平台中的定位

值得注意的是,飞书 CLI 并不是飞书低代码平台的唯一命令行工具。

飞书低代码平台(aPaaS)也有自己的 CLI 工具,比如 kldx 命令,用于自定义组件开发、云函数开发、源码部署等场景。

kldx 的功能包括:登录鉴权、项目克隆、组件创建、本地调试、源码同步、构建任务追踪等。

这两个 CLI 工具面向不同的用户群体:

  • kldx
    :面向低代码平台开发者,用于构建飞书应用
  • lark-cli
    :面向 AI Agent 和开发者,用于操作飞书数据

7.3 对 AI Agent 生态的影响

飞书 CLI 的开源,对整个 AI Agent 生态有三个深远影响:

第一,降低 AI 接入飞书的门槛。以前,让 AI 操作飞书需要开发者写代码对接 API。现在,装一个 CLI 就行。 第二,树立了”AI 原生”的设计标杆。出错引导、权限自动补授、dry-run 预览、多格式输出……这些设计理念值得其他 SaaS 产品学习。 第三,推动了”软件 CLI 化”的行业趋势。飞书开了这个头,其他办公软件(钉钉、企业微信、Notion 等)会不会跟进?大概率会。这对整个行业都是好事。

第八章:未来展望——当所有软件都 CLI 化

> “如果这个世界,所有的软件都能跟飞书一样 CLI 化。如果所有你日常使用的软件,都有一层 CLI,都可以被 AI 直接调用。那时候,我们心中所想的科幻世界里的那个超级 AI 助理,就真的即将快被实现了。”

8.1 超级 AI 助理的样子

想象一下这样的场景:

  • 你的 AI 助理可以同时操作飞书、钉钉、企业微信——跨平台协同不再是问题
  • 你的 AI 助理可以操作你的邮箱、日历、文档、任务——办公全流程自动化
  • 你的 AI 助理可以操作你的 CRM、ERP、财务系统——企业级流程自动化

这就是”超级 AI 助理”的样子。它不是某个单一功能的工具,而是能调用所有软件完成复合任务的智能体。

8.2 软件公司的两种生存策略

在 AI Agent 时代,软件公司有两种生存策略:

策略一:让 AI 能调用你。提供 CLI 接口,让 AI 可以直接操作你的软件。飞书选择了这条路。 策略二:把自己变成 AI。软件本身就是一个 AI Agent,直接帮用户完成任务。比如一些 AI 原生的生产力工具。

两种策略没有高下之分,但有一点是确定的:如果你不提供 AI 可调用的接口,你的软件就会被边缘化

8.3 给开发者和企业的建议

如果你是开发者:
  • 立即体验飞书 CLI
    。这不是”以后有用”的工具,现在就能用。花 30 分钟安装配置,感受一下 AI 操作飞书的体验。
  • 学习”AI 原生”的设计理念
    。出错引导、dry-run 预览、多格式输出……这些理念可以应用到你自己的产品中。
  • 关注 AI Agent 生态
    。Claude Code、Cursor、Codex、OpenClaw……这些工具正在快速发展,提前布局。
如果你是企业 IT 负责人:
  • 评估飞书 CLI 在企业内的应用场景
    。哪些重复性工作可以自动化?哪些流程可以交给 AI Agent?
  • 建立 AI Agent 管理规范
    。AI Agent 以用户身份还是应用身份操作?权限如何管理?日志如何审计?这些问题需要提前考虑。
  • 关注 AI Agent 安全
    。虽然飞书 CLI 有输入防护、输出清理、操作确认等安全机制,但企业级的治理还需要补充。

写在最后:一个新时代的开始

飞书 CLI 的开源,不是一个普通的产品发布。

它是一个信号——软件正在为 AI 让路

过去 40 年,我们习惯了”看到按钮就点”。未来,我们会习惯”对 AI 说一句话,它自己去点按钮”。

GUI 不会消失。就像 CLI 当年没有被 GUI 完全取代一样,GUI 依然会存在,因为它适合人类。但一个新的时代正在到来——AI 将成为软件的主要用户之一

在这个新时代里,飞书迈出了关键的一步。它把整个办公套件压缩成了一套命令行工具,为 AI Agent 铺平了道路。

其他的软件呢?钉钉会跟进吗?企业微信会跟进吗?Notion、Slack、Teams 呢?

我们拭目以待。

但有一件事是确定的:那个科幻世界里的超级 AI 助理,正在从想象变成现实

而今天,2026 年 3 月 28 日,我们见证了这个进程中的一个重要节点。


📎 相关链接:
  • 飞书 CLI GitHub:https://github.com/larksuite/cli
  • 飞书开放平台:https://open.feishu.cn/
  • OpenClaw 项目:https://github.com/openclaw/openclaw
  • feishu-mcp(社区项目):https://github.com/chuanshuju/feishu-mcp