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

引言“Built for humans and AI Agents.”这是「一天一个开源项目」系列的第 62 篇文章。今天介绍的项目是lark-cliGitHub。需要在终端或 AI 工作流里操作飞书/Larklark-cli是larksuite 团队维护的官方 CLI11 个业务域、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分发以npmlarksuite/cli为主配套需安装CLI SKILLnpx skills add larksuite/cli -y -g项目数据⭐GitHub Stars: 约 6k见 仓库License: MITnpm: 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 解析。使用场景日程与会议calendar agenda、创建日程、忙闲查询、会议妙记/纪要相关能力配合对应 SkillIM 与群聊发消息、搜消息、管理群成员、传图传文件文档与表格Markdown 建文档、读写单元格、导出表格多维表格 Base建表、字段、记录、视图、仪表盘配合lark-baseSkill邮箱与任务起草/发送邮件、待办与清单快速开始# 安装 CLInpminstall-glarksuite/cli# 安装 CLI SKILL官方要求供 Agent 使用npx skillsaddlarksuite/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 3gitclone https://github.com/larksuite/cli.gitcdclimakeinstallnpx skillsaddlarksuite/cli-y-g核心特性三层体系Shortcuts → 领域 API 子命令 →lark-cli api原始 HTTP19 Agent Skills如lark-calendar、lark-im、lark-doc、lark-base、lark-mail、lark-vc等身份切换--as user/--as bot在同一应用下切换调用身份Schema 自省lark-cli schema查看参数、body、权限范围安全默认输入注入防护、终端输出脱敏、系统钥匙链存凭证设计目标使用前仍应阅读官方安全说明分页与 dry-run--page-all、--dry-run降低误操作风险项目优势对比项lark-cli手写 curl/SDK仅网页操作上手一条命令 OAuth需查文档、拼 URL无代码AgentSkills 结构化输出需自建封装无法自动化覆盖面200 命令 2500 API 兜底自维护视界面而定许可MIT 开源视 SDK 而定—为什么选它官方维护与 OpenAPI 元数据对齐同时服务人与 Agent减少重复造轮子MIT可集成进内部工具链项目详细剖析三层命令体系层级形式用途Shortcutslark-cli 域 动作人类与 Agent 友好默认值与表格输出API Commandslark-cli calendar calendars list等与平台接口 1:1 映射100 精选命令Raw APIlark-cli api GETPOST …Agent Skills节选Skill能力摘要lark-shared配置、登录、身份、scope、权限与安全问题lark-calendar日程、忙闲、时间建议lark-im消息、群聊、搜索、媒体lark-doc/lark-drive/lark-sheets/lark-base文档、文件、表格、多维表格lark-mail/lark-task/lark-contact/lark-wiki邮件、任务、通讯录、知识库lark-event/lark-vc/lark-minutes事件订阅、会议记录、妙记lark-openapi-explorer从官方文档探索底层 APIlark-workflow-*会议摘要、站会日程待办等工作流完整列表见仓库 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: https://github.com/larksuite/clinpm: https://www.npmjs.com/package/larksuite/cli中文 README: README.zh.mdIssues: https://github.com/larksuite/cli/issues适用人群需脚本化/自动化飞书/Lark 的开发者与运维在 Cursor、Claude 等环境中为 Agent 配置 Lark 能力的团队希望少写胶水代码、直接对齐官方 API 语义的用户欢迎来我中的个人主页找到更多有用的知识和有趣的产品