2026 年 3 月 28 日,飞书官方开源 larksuite/cli(v1.0.0),以 200+ 命令、19 个 AI Agent Skills,将飞书 2500+ 开放 API 封装为命令行接口,面向人类开发者与 AI Agent 双用户,重构办公协作的操作范式。这不仅是工具升级,更是飞书从'GUI 服务人'到'GUI+CLI 双态并行'的战略跃迁——GUI 给人交互,CLI 给 AI 执行,让 AI 真正成为办公的'执行者'而非'旁观者'。
一、飞书 CLI 是什么:从 API 到命令行的能力跃迁
1. 核心定位与架构
飞书 CLI 是官方开源、MIT 协议、免费商用的命令行工具,核心定位是让 AI Agent 直接操控飞书全量数据与业务,而非仅做信息查询。其三层架构清晰划分能力边界:
- Shortcuts 层:高频快捷命令(如
lark-cli calendar +agenda查今日日程),降低人类使用门槛。 - API Commands 层:200+ 精选命令,与飞书开放 API 一一映射,覆盖 11 大核心业务域。
- Raw API 层:直接调用飞书 2500+ 全部 OpenAPI,满足深度定制开发需求。
2. 能力全景:11 大业务域全覆盖
飞书 CLI 打通飞书全生态,覆盖消息、文档、日历、邮件、表格、多维表格、任务、审批、知识库、组织架构、会议纪要等核心场景,实现'你的飞书,CLI 全能管':
| 业务域 | 核心能力 | 典型命令示例 |
|---|---|---|
| 消息/群聊 | 发消息、搜群聊、管成员、查历史 | lark-cli im +messages-send --chat-id "oc_xxx" --text "通知" |
| 文档 | 创建/读写/更新、Markdown 双向转换 | lark-cli docs +create --title "周报" --markdown "# 内容" |
| 日历 | 查日程、建会议、邀参会、查忙闲 | lark-cli calendar +events-create --title "评审会" --start "2026-03-30 10:00" |
| 多维表格 | 批量增删改查、数据同步 | lark-cli base +records-batch-create --app-token "xxx" --records "[{...}]" |
| 任务 | 列任务、改状态、设截止时间 | lark-cli task +list --completed false |
3. 关键优势:为什么 CLI 是 AI 时代的最优解
对比传统 GUI 操作与 API 调用,飞书 CLI 的优势直击 AI 协作痛点:
- AI 友好:纯文本指令 + 结构化输出,无需模拟点击、识别界面,LLM 天然适配命令行语法,19 个内置 AI Skills 即插即用。
- 效率极致:一行命令替代多步 GUI 操作,支持脚本化、管道化、批量执行,自动化效率提升 10 倍+。
- 灵活可控:开源可定制、本地可部署、支持 Dry-run 预览、权限严格校验,兼顾开发自由度与企业安全。
- 生态兼容:无缝对接 Claude Code、Cursor 等主流 AI 工具,无需额外适配,3 分钟接入办公生态。
二、飞书 CLI 开发能力:从安装到实战的全流程
1. 环境准备与安装(3 分钟快速上手)
(1)前置条件
- Node.js ≥16.0.0(推荐 v18.20.5),npm/npx 可用。
- 飞书账号(企业/个人均可,需扫码授权)。
(2)安装步骤(推荐 npm 方式)
# 1. 安装 CLI 核心工具
npm install -g @larksuite/cli --registry https://registry.npmmirror.com
# 2. 初始化配置(扫码授权,自动生成配置文件)
lark-cli config init
# 3. 安装 AI Agent Skills(必需,解锁 19 个开箱即用能力)
npx skills add larksuite/cli --all -y -g
# 验证安装成功
lark-cli --version
避坑:必须安装 Skills,否则 AI Agent 无法直接调用 CLI 能力;国内推荐使用 npm 镜像源加速安装。
2. 核心开发能力详解
(1)命令行基础操作
- 鉴权管理:
lark-cli auth login(登录)、lark-cli auth logout(登出)、lark-cli auth whoami(查看当前用户)。 - 命令查询:
lark-cli [模块] +[命令] --help(如lark-cli im +messages-send --help),快速获取参数说明。 - 批量操作:支持循环、管道、脚本调用,实现数据批量处理(如批量导出周报、批量创建任务)。
(2)AI Agent 集成开发(核心场景)
飞书 CLI 的最大价值是让 AI Agent 具备'执行能力',19 个内置 Skills 覆盖高频办公场景,无需开发者从零适配:
- Skill 调用方式:在 Claude Code/Cursor 中直接输入自然语言指令,AI 自动解析并调用对应 CLI 命令。
示例 1:AI 自动生成周报
# 自然语言指令:帮我汇总今日任务、项目群消息,生成周报并发送到部门群
# AI 自动执行的 CLI 命令
lark-cli task +list --completed false --date today > tasks.md
lark-cli im +messages-search --query "项目进展" --chat-id "oc_xxx" --date today > messages.md
cat tasks.md messages.md > week-report.md
lark-cli docs +create --title "今日周报" --markdown "$(cat week-report.md)"
lark-cli im +messages-send --chat-id "oc_dept" --text "今日周报已生成:[文档链接]"
示例 2:CI/CD 自动化通知
在 Jenkins/GitLab CI 中集成 CLI,部署成功后自动发飞书群通知:
# CI 脚本片段
if [ $DEPLOY_STATUS == "success" ]; then
lark-cli im +messages-send --chat-id "oc_dev" --text "✅ 项目 v1.0.0 部署成功!"
else
lark-cli im +messages-send --chat-id "oc_dev" --text "❌ 部署失败,请检查日志"
fi
(3)企业级安全与权限控制
飞书 CLI 内置多重安全机制,满足企业合规要求:
- 权限最小化:扫码授权时仅开放必要权限,支持自定义权限范围。
- 操作审计:所有 CLI 操作记录可追溯,支持日志导出。
- Dry-run 模式:
--dry-run参数预览命令执行结果,避免误操作。 - 凭据托管:安全存储授权信息,无需手动管理密钥。
3. 开发场景与价值落地
(1)开发者场景:降低飞书集成门槛
- API 快速调试:无需编写代码,直接用 CLI 命令测试 OpenAPI,提升开发效率。
- 批量数据处理:一键导出/导入飞书数据(如多维表格、文档),替代手动复制粘贴。
- 自定义工具开发:基于 CLI 封装企业内部工具(如考勤统计、报表生成),实现办公流程自动化。
(2)AI Agent 场景:重构人机协作模式
- 个人 AI 助理:让 Claude Code/Cursor 直接帮你发消息、建会议、写文档,实现'对话即操作'。
- 企业 AI 中枢:搭建企业级 AI Agent,统一调度飞书 CLI 能力,自动处理审批、任务、数据同步等流程。
- 跨系统协同:CLI 作为桥梁,打通飞书与 GitHub、Jenkins、ERP 等系统,实现全链路自动化。
(3)DevOps 场景:CI/CD 与运维自动化
- 部署通知:集成 CI/CD 流程,自动发送部署状态到飞书群,提升团队协作效率。
- 监控告警:结合监控工具,通过 CLI 发送告警消息到指定群组,快速响应故障。
- 资源管理:批量管理飞书组织架构、用户权限,简化企业 IT 运维工作。
三、飞书 CLI 的战略意义:AI 时代办公的新基建
1. 行业趋势:从'人机协作'到'人机共生'
软件演化路径正逆向回归:CLI → GUI → CLI(AI 专用)。飞书 CLI 的开源,标志着办公软件正式进入双态并行时代——GUI 服务人类的交互需求,CLI 服务 AI 的执行需求。这不是倒退,而是为 AI 量身打造的'操作层',让 AI 从'信息助手'升级为'工作伙伴'。
2. 飞书生态的核心价值
- 开放生态升级:从'API 开放'到'命令行开放',降低 AI 与飞书集成的技术门槛,吸引更多开发者与 AI 工具接入。
- 企业效率革命:通过 CLI 实现办公流程自动化、AI 化,减少重复劳动,让员工聚焦高价值工作,整体效率提升 50%+。
- AI 落地加速器:解决 AI'能说不能做'的痛点,让 AI 真正参与办公执行,加速企业 AI 转型进程。
3. 未来展望
飞书 CLI 有望成为办公自动化的标准接口:
- 成为所有 AI 工具与飞书交互的'通用语言',实现跨工具、跨平台的无缝协同。
- 演进为企业 RPA、工作流编排的核心组件,支撑复杂业务流程的自动化执行。
- 持续迭代,覆盖更多飞书能力,同时开放更多定制化接口,满足企业个性化需求。
四、总结与行动建议
飞书 CLI 的开源,是 AI 时代办公领域的里程碑事件。它不仅是一款工具,更是一套面向未来的办公基础设施,为人类开发者与 AI Agent 提供了统一、高效、安全的操作入口。
行动建议
- 立即体验:按本文教程安装飞书 CLI,尝试基础命令与 AI 集成,感受命令行办公的效率。
- 场景落地:结合企业实际需求,优先落地 AI 周报、CI/CD 通知、批量数据处理等高频场景。
- 生态共建:参与飞书 CLI 开源社区,提交 Issue、PR,共同完善工具能力,共享 AI 办公红利。
未来已来,CLI 不是飞书的终点,而是 AI 办公时代的起点。拥抱飞书 CLI,就是拥抱更高效、更智能的办公未来。


