一天一个开源项目（第62篇）：lark-cli - 飞书/Lark 官方 CLI 与 AI Agent Skills

引言

这是「一天一个开源项目」系列的第 62 篇文章。今天介绍的项目是 lark-cli（GitHub）。

需要在终端或 AI 工作流里操作飞书/Lark？lark-cli 是 larksuite 团队维护的官方 CLI：11 个业务域、200+ 命令、19 个 AI Agent Skills，三层指令体系（Shortcuts → API Commands → Raw API），参数为 Agent 优化、结构化输出，支持 OAuth 登录、user/bot 身份切换、dry-run 与安全默认。MIT 开源，npm install -g @larksuite/cli 即可使用。

你将学到什么

• lark-cli 的定位：人 + Agent 双场景
• 三层命令体系与典型用法
• 19 个 Agent Skills 覆盖哪些能力
• 认证、Scope、--as user/bot 身份切换
• 安全提示与使用边界

前置知识

• 有飞书或 Lark 租户与开放平台应用（自建应用）概念
• 熟悉终端、npm 更佳（可选）

项目背景

项目简介

lark-cli 是 Lark / 飞书 官方命令行工具，用于在本地通过开放平台 API 操作日历、即时消息、云文档、云盘、多维表格、电子表格、任务、知识库、通讯录、邮箱、视频会议等。设计上强调 Agent-Native：自带结构化 Skills，与 Cursor、Claude 等工具兼容，减少代理「瞎调 API」的成本。

维护方

• 团队：larksuite（官方）
• 语言：Go（源码构建需 Go 1.23+）；分发以 npm @larksuite/cli 为主
• 配套：需安装 CLI SKILL（npx skills add larksuite/cli -y -g）

项目数据

• ⭐ GitHub Stars: 约 6k+（见 仓库）
• License: MIT
• npm: @larksuite/cli
• 产品: Lark / 飞书开放平台

主要功能

核心作用

用一个工具覆盖 Messenger、Docs、Drive、Base、Sheets、Calendar、Mail、Tasks、Wiki、Contact、Meetings 等；人类用户用 + 快捷指令快速办事，进阶用户用 API 命令 对齐平台元数据，需要兜底时用 lark-cli api 直调用 2500+ Open API。输出支持 json / pretty / table / ndjson / csv，适合脚本与 Agent 解析。

使用场景

1. 日程与会议：calendar +agenda、创建日程、忙闲查询、会议妙记/纪要相关能力（配合对应 Skill）
2. IM 与群聊：发消息、搜消息、管理群成员、传图传文件
3. 文档与表格：Markdown 建文档、读写单元格、导出表格
4. 多维表格 Base：建表、字段、记录、视图、仪表盘（配合 lark-base Skill）
5. 邮箱与任务：起草/发送邮件、待办与清单

快速开始

# 安装 CLI
npm install -g @larksuite/cli

# 安装 CLI SKILL（官方要求，供 Agent 使用）
npx skills add larksuite/cli -y -g

# 一次性配置应用凭证（交互引导）
lark-cli config init

# 登录（推荐使用常用 scope 组合）
lark-cli auth login --recommend

# 验证状态
lark-cli auth status

# 示例：查看日程
lark-cli calendar +agenda

从源码构建（需 Go 1.23+、Python 3）：

git clone  && cd cli
make install
npx skills add larksuite/cli -y -g

核心特性

1. 三层体系：+ Shortcuts → 领域 API 子命令 → lark-cli api 原始 HTTP
2. 19 Agent Skills：如 lark-calendar、lark-im、lark-doc、lark-base、lark-mail、lark-vc 等
3. 身份切换：--as user / --as bot 在同一应用下切换调用身份
4. Schema 自省：lark-cli schema 查看参数、body、权限范围
5. 安全默认：输入注入防护、终端输出脱敏、系统钥匙链存凭证（设计目标；使用前仍应阅读官方安全说明）
6. 分页与 dry-run：--page-all、--dry-run 降低误操作风险

项目优势

为什么选它？

• 官方维护，与 OpenAPI 元数据对齐
• 同时服务人与 Agent，减少重复造轮子
• MIT，可集成进内部工具链

项目详细剖析

三层命令体系

Agent Skills（节选）

完整列表见仓库 README - Agent Skills。

认证与 Agent 流程

• lark-cli config init / config init --new：创建或绑定开放平台应用
• lark-cli auth login --recommend：推荐范围一键授权
• Agent 模式：auth login --no-wait 返回验证 URL，用户浏览器完成后可 device-code 续轮询

安全与风险（务必阅读官方说明）

CLI 可被 AI 代操作，存在幻觉、注入、超范围操作等风险；授权后 Agent 在 granted scope 内等同于你的身份。不要将集成该工具的 bot 暴露给不可信群聊；勿随意放宽默认安全策略。使用前请阅读仓库中的 Security & Risk Warnings。

项目地址与资源

官方资源

• GitHub: github.com/larksuite/c…
• npm: www.npmjs.com/package/@la…
• 中文 README: README.zh.md
• Issues: github.com/larksuite/c…

适用人群

• 需脚本化/自动化飞书/Lark 的开发者与运维
• 在 Cursor、Claude 等环境中为 Agent 配置 Lark 能力的团队
• 希望少写胶水代码、直接对齐官方 API 语义的用户

欢迎来我中的个人主页找到更多有用的知识和有趣的产品