一、项目介绍

做飞书生态自动化时，最常用的痛点是“每接一个能力就写一遍鉴权与 API 封装”：发消息、读写文档、操作多维表格、查日历，零散的脚本越积越多，还很难被 AI 助手直接调用。你想让 Agent 帮你自动发周报、填表格，却卡在工具暴露方式上。
Lark CLI 是飞书官方维护的命令行工具，既给人用，也为 AI 智能体设计。它一口气覆盖消息、文档、多维表格、日历、邮件、任务、会议等 18 个业务域、200+ 命令，并内置 26 个 Agent Skills。三层架构从快捷命令到原始 API 任选粒度，Agent 零额外配置就能操作飞书——等于把整个飞书变成可被脚本和智能体驱动的操纵面。

二、项目基本信息

信息项详情
项目名称Lark-CLI
GitHub地址https://github.com/larksuite/cli
项目描述The official Lark/飞书 CLI tool, maintained by the larksuite team — built for humans and AI Agents. Covers core business domains including Messenger, Docs, Base, Sheets, Calendar, Mail, Tasks, Meetings, and more, with 200+ commands and 20+ AI Agent Skills.
作者larksuite
开源协议MIT
开源状态公开
LanguagesGo
支持平台Windows / macOS / Linux
最后更新2026-10-29

三、核心优势

  • 智能体原生：内置 26 个 Agent Skills，Agent 零配置可调用
  • 覆盖广：18 个业务域、200+ 命令一条命令搞定
  • 三层架构：快捷命令 / API 命令 / 原始 API 任选粒度
  • 3 分钟上手：一键建应用、交互登录，三步到首次调用
  • 安全可靠：输入注入防护、终端输出清洗、系统钥匙串存凭证

四、适用场景

适合用飞书做协作与自动化的团队：想把消息通知、文档处理、表格填报、日程管理交给脚本或 AI 智能体，减少重复手写 API 封装。

五、安装教程

当前最新版本 v1.0.98。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 通过 npm 全局安装（需 Node.js 环境）
npm install -g @larksuite/cli
# 首次使用交互登录授权
lark login

常见报错：依赖缺失时先升级运行环境（Node、Python、Go 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 发送一条消息到指定会话
lark msg send <chat_id> "每日构建已完成"
# 列出当前可用命令与技能
lark --help

七、常见问题

问：必须懂飞书开放平台吗？答：不必，CLI 封装了鉴权与常用命令，登录即可用。问：Agent 怎么调用？答：内置 Skills 兼容主流 AI 工具，Agent 可直接发起结构化调用。

八、总结

Lark-CLI 用一个清晰的设计，把把高频运维动作自动化这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。