飞书 CLI(Lark CLI) 是字节跳动飞书官方于 2026 年 3 月开源的命令行工具(Command-Line Interface),二进制名为 lark-cli,npm 包为 @larksuite/cli。
一、核心定义
本质:将飞书开放平台 2500+ API 封装成 200+ 条终端命令
定位:面向开发者 + AI Agent 原生设计(Built for humans and AI Agents)
协议:MIT 开源免费,可商用、可二次开发
覆盖:11 大业务域(消息、文档、表格、日历、邮件、任务、审批、组织架构、会议、知识库、多维表格)
二、主要用途(能做什么)
- 开发者:终端高效操控飞书(替代 GUI)
消息 / 群聊:发消息、搜聊天记录、建群、加人
bash
运行
lark-cli message send --chat 群ID --text "CLI 发消息"
云文档:Markdown ↔ 飞书文档双向无损转换(解决格式乱、Mermaid 无法编辑)
bash
运行
lark-cli doc import --input README.md --title "CLI 导入文档"
日历 / 会议:查日程、建会议、查忙闲
bash
运行
lark-cli calendar agenda --today
表格 / 多维表格:读写数据、批量操作
组织架构:查成员、部门、权限
- AI Agent:让 AI 直接 "操作" 飞书(核心价值)
内置 19 个 AI Agent Skills:
Claude Code、Cursor、GPT 等无需改造,直接调用
AI 可发消息、读文档、改表格、建日程、发邮件
自然语言 → CLI 命令 → 飞书操作(AI 真正 "办公")
- 自动化 / 脚本:批量 / 定时办公
写 Shell/Python 脚本:自动日报、周报、批量发通知、数据同步、备份文档
对接 CI/CD、监控系统:告警自动发飞书群
- 三层架构(灵活使用)
Shortcuts(快捷命令):lark-cli calendar agenda(人类易用)
API Commands(标准命令):200+ 命令,映射 API
Raw API(原始调用):直接调用 2500+ 全部 API(深度定制)
三、典型场景价值
开发者:终端办公、不切 GUI、脚本自动化
AI 办公:AI 助手直接处理飞书事务
团队 / 企业:批量操作、数据同步、安全可控(凭证本地加密)
一句话:飞书 CLI = 终端版飞书 + AI 操控飞书的桥梁。