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
lark-cli config init
npx skills add larksuite/cli --all -y -g
lark-cli --version
