Feishu CLI for Humans and Agents
把飞书操作带进终端和 AI Agent
用 lark-cli 创建文档、更新多维表格、查看日程、发送消息，并让 Agent 按安全流程调用飞书能力。
npx @larksuite/cli@latest install
Who It Helps
把飞书里的重复操作，变成可复用的命令
如果你想把飞书接进脚本、自动化任务或 AI Agent，先从下面三条路径判断是否适合。
Verified From README
官方定位不是“命令大全”，而是工作流入口
官方 README 把 lark-cli 描述为面向人类和 AI Agent 的飞书终端工具；它同时提供短命令、平台 API 映射、通用 API 调用和 Agent Skills。
Scenarios
典型使用场景
下面这些不是穷举命令，而是最容易理解 lark-cli 价值的真实工作流。
把 Markdown 写进飞书
让文档创建、读取、追加、改写变成命令，适合 AI Agent 产出方案、周报、PRD 后写入飞书文档。
lark-cli docs +create
批量处理多维表格
创建字段、写入记录、查询聚合、管理视图和仪表盘，适合任务台账、内容库、线索库和运营数据表。
lark-cli base +record-upsert
日程和会议助手
查看日程、创建会议、查忙闲、推荐时间、预定会议室，把“今天安排什么”交给终端或 Agent。
lark-cli calendar +agenda
发送消息和处理协作
给群或用户发通知、回复消息、管理群聊、搜索历史、下载图片和文件，适合自动站会和项目提醒。
lark-cli im +messages-send
邮件和任务流转
浏览、搜索、回复邮件；创建、查询、完成任务；把收件箱、待办和提醒接进日常自动化。
lark-cli mail +triage
lark-cli task +get-my-tasks
会议纪要和录制资料
搜索会议记录，查询妙记总结、待办、章节和转写内容，适合把会后信息整理成结构化报告。
lark-cli minutes +search
发布和管理飞书应用
`apps` 域提供创建应用、发布 HTML、管理发布记录、会话和数据库环境等能力。
lark-cli apps +html-publish
脚本和数据管道
用 JSON、NDJSON、CSV 输出，把飞书记录接给 jq、CI、日志系统或自定义分析脚本。
--format json / --page-all
Coverage
覆盖哪些飞书能力
从官方 README 和本机 `lark-cli --help` 看，常用顶级域覆盖这些方向。
docs 云文档
base 多维表格
sheets 电子表格
slides 幻灯片
im 即时通讯
calendar 日历
mail 邮箱
task 任务
wiki 知识库
drive 云空间
apps 应用
approval 审批
vc 视频会议
minutes 妙记
whiteboard 画板
api 通用调用
schema 参数查看
skills Agent 技能
Command System
三层命令结构怎么选
lark-cli 不是只包装几个快捷命令。官方 README 把它分成三个粒度：越往下越接近开放平台原始 API。
Shortcuts：人和 Agent 都好用
以 `+` 开头，参数更短，带智能默认值，适合日常任务和 Agent 调用。
lark-cli calendar +agenda
lark-cli docs +create --doc-format markdown
API Commands：映射平台端点
面向熟悉开放平台的用户，命令和接口更接近，适合脚本里精确控制请求。
lark-cli calendar calendars list
lark-cli calendar events instance_view
Raw API：覆盖长尾能力
当快捷命令还没覆盖某个接口时，可以直接调用开放平台路径。
lark-cli api GET /open-apis/calendar/v4/calendars
Start
三分钟快速开始
以下命令来自官方 README 或本机 CLI 帮助。真正执行前，请按 README 完成应用配置和授权。
-
安装 CLI
npx @larksuite/cli@latest install官方推荐从 npm 安装，安装后获得 `lark-cli` 命令。
-
配置应用
lark-cli config init交互式配置应用凭证，AI Agent 协助时可使用 `--new` 分步引导。
-
登录授权
lark-cli auth login --recommend按推荐 scope 授权，后续命令才能访问你的飞书资源。
-
验证使用
lark-cli calendar +agenda查看近期日程，确认配置、认证和网络连通。
Automation
脚本化时真正好用的能力
做自动化时，关键不是“能不能调 API”，而是输出、分页、预览和参数自检是否稳定。
结构化输出
用 `--format json` 给 Agent 解析，用 `--format ndjson` 流式处理大量记录，用 `--format csv` 交给表格工具。
lark-cli base +record-list --format ndjson
自动翻页
读取多页记录时用 `--page-all`，避免每个脚本都自己写分页循环。
lark-cli calendar calendars list --page-all
危险操作预览
发消息、删数据、改权限前先 `--dry-run`，让人和 Agent 都能看到将要发出的请求。
lark-cli im +messages-send --dry-run
schema 参数自检
不确定某个接口需要什么参数、scope 或身份时，先用 `schema` 看结构，再让 Agent 执行。
lark-cli schema im.messages.delete
AI Agent Skills
为什么它适合 AI Agent
CLI 只是入口，Skills 才是让 Agent 稳定工作的操作手册。官方 README 提到 lark-cli 配套 26 个 Skills，覆盖认证、文档、多维表格、日历、消息、表格、幻灯片、任务、邮箱、Wiki 等场景。
安装全部 Skills
npx skills add larksuite/cli -g -y
或只装指定领域
npx skills add larksuite/cli -s lark-doc -y
Boundary
安全和使用边界
- 本站只做功能和场景介绍，不在线执行飞书 CLI。
- 具体参数、权限和最新命令以官方 README、本机 `lark-cli --help`、`lark-cli schema` 为准。
- 飞书项目管理由独立的 meegle-cli 提供，不能混进 lark-cli 的能力里。
- 区分 `--as user` 和 `--as bot`：用户资源、个人日历、云空间和邮箱通常需要用户授权。
- 涉及写入、删除、审批、发消息、权限修改等操作时，先用 `--dry-run` 或人工确认。
- 不要把已授权的 Agent 随意拉进群聊或让无关人员触发，避免权限滥用和数据泄漏。
Sources
官方资源
需要准确命令、最新版本和完整参数时，以官方资料为准。