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

引言

"Built for humans and AI Agents."

这是「一天一个开源项目」系列的第 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)

项目数据


主要功能

核心作用

用一个工具覆盖 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. 邮箱与任务:起草/发送邮件、待办与清单

快速开始

bash 复制代码
# 安装 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):

bash 复制代码
git clone https://github.com/larksuite/cli.git && 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 降低误操作风险

项目优势

对比项 lark-cli 手写 curl/SDK 仅网页操作
上手 一条命令 + OAuth 需查文档、拼 URL 无代码
Agent Skills + 结构化输出 需自建封装 无法自动化
覆盖面 200+ 命令 + 2500+ API 兜底 自维护 视界面而定
许可 MIT 开源 视 SDK 而定 ---

为什么选它?

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

项目详细剖析

三层命令体系

| 层级 | 形式 | 用途 |
|:-----------------|:-------------------------------------|:-----------------------|-------------------------|
| Shortcuts | lark-cli <域> +<动作> | 人类与 Agent 友好,默认值与表格输出 |
| API Commands | lark-cli calendar calendars list 等 | 与平台接口 1:1 映射,100+ 精选命令 |
| Raw API | `lark-cli api GET | POST ...` | 任意 Open Platform 路径,全覆盖 |

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 从官方文档探索底层 API
lark-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。


项目地址与资源

官方资源

适用人群

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

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

相关推荐
chh56314 小时前
从 BERT 到大模型:让模型从“会接龙”到“会回答
人工智能·深度学习·bert
TomEval14 小时前
【测AI】第26篇:线上模型监控与告警体系 — 测试不是终点
人工智能·python·功能测试·ai
ZhengEnCi15 小时前
AI 总模仿代码库里的过时写法怎么办:先清坏样例,再用类型与测试让 AI 无法犯错
人工智能·ai编程
一只爱撸猫的程序猿15 小时前
五周、两个开源仓库、九次拦截之后:AI 时代程序员缺的到底是什么
人工智能·后端·开源
GitCode官方15 小时前
开源鸿蒙跨平台直播|AI 时代,用 cj-tauri 开发鸿蒙 PC 应用
人工智能·华为·harmonyos·atomgit
老金带你玩AI16 小时前
GPT-6.2更强更便宜了,为什么还有人骂?
人工智能
CyrusYiVPP16 小时前
实测 uv 0.13.7:同一套包,pip 装 94 秒,它只用 19 秒
人工智能·python
泯泷16 小时前
OpenClaw 退潮背后,是 AI 圈“技术自嗨”的终结
人工智能·chatgpt·llm
罗西的思考16 小时前
【轻量化复刻大模型 / KIMI K3】Muon 优化器及 训练系统
人工智能·算法·机器学习
屿华AI16 小时前
AUTOSAR 实战-诊断工具 | 用 Claude Code 开发诊断测试工具:AI 协作开发实践
人工智能·测试工具