飞书/Lark 开放平台命令行工具 —— 一款专为人类开发者和 AI Agent 设计的终端工具,让你在命令行中直接操作飞书的各项服务。它覆盖了即时消息、云文档、多维表格、电子表格、日历、邮箱、任务、视频会议等核心业务域,提供了 200+ 条精选命令 及 19 个开箱即用的 AI Agent Skills。

为什么选择 lark-cli?
你是否曾想过,能否像在终端里操作本地文件一样,快速查询同事的忙闲状态、给文档评论或者拉取会议纪要?lark-cli 就是为了实现这种无缝的“人-机-平台”交互而生的。它不仅仅是 API 的简单封装,更是一套经过深度优化的生产力工具集。
- 为 AI Agent 原生设计:内置的 19 个 Skills 无需任何适配即可被主流的 AI Agent 框架(如 LangChain、AutoGen)直接调用,极大降低了 AI 集成飞书能力的门槛。
- 覆盖面极广:囊括了 11 个主要业务领域,超过 200 条高频命令,几乎满足了日常办公自动化中的所有场景需求。
- AI 友好调优:每一条命令都经过 Agent 实测验证,提供更友好的参数命名、智能默认值以及高度结构化的 JSON 输出,显著提升了 AI 调用的成功率和准确性。
- 开源零门槛:采用宽松的 MIT 协议开源,通过 npm 即可一键安装,开发者可以自由使用、研究和贡献代码。
- 三分钟快速上手:提供交互式引导,从创建飞书应用到完成首次授权登录、执行第一条命令,最快只需几个步骤。
- 安全可控:具备输入防注入、终端输出净化等安全特性,并使用操作系统原生的密钥链来安全存储访问凭证。
- 灵活的三层调用架构:
- 快捷命令:高度封装,人类可读,适合手动执行。
- API 命令:与飞书开放平台 API 严格同步,适合脚本调用。
- 通用调用:覆盖平台所有 API,提供最大的灵活性。
核心功能一览
lark-cli 的功能到底有多全面?下面的表格清晰地展示了它在各个业务模块中的核心操作能力。

19 个 AI Agent Skills 详解
对于想要构建智能工作流的开发者来说,Skills 是关键。lark-cli 将这些命令模块化,封装成一个个独立的 Skill,方便 AI Agent 按需加载和组合使用。这也是该项目在 开源实战 领域的一大亮点。

从上表可以看出,除了基础的日历 (lark-calendar)、消息 (lark-im)、文档 (lark-doc) 等技能外,还提供了如事件订阅 (lark-event)、自定义技能框架 (lark-skill-maker) 甚至预置的工作流(如会议纪要汇总),为构建复杂的自动化 Node.js 应用或 AI Agent 提供了强大的基础设施。
如何安装使用?
安装过程非常简单,你可以选择从 npm 安装(推荐)或从源码构建。
方式一:从 npm 安装(推荐)
# 安装 CLI 本体
npm install -g @larksuite/cli
# 安装 CLI SKILL(必需步骤)
npx skills add larksuite/cli -y -g
方式二:从源码安装
git clone https://github.com/larksuite/cli.git
cd cli
make install
# 安装 CLI SKILL(必需步骤)
npx skills add larksuite/cli -y -g
安装完成后,执行 lark --help 即可查看所有可用命令,开始你的飞书命令行之旅。
项目地址
https://github.com/larksuite/cli/tree/main
对于任何命令行工具来说,清晰、完整的 技术文档 都是快速上手的关键。lark-cli 的 GitHub 仓库提供了详细的说明,欢迎访问 云栈社区 与更多开发者交流使用心得和自动化脚本。
|