开源 · MIT 许可证 · v1.0.0

官方 Feishu CLI
面向 AI Agent 与开发者

Feishu CLI(Lark CLI)是字节跳动旗下飞书开放平台推出的官方开源命令行工具。覆盖 11 大业务领域,提供 200+ 命令与 19 个内置 AI Agent Skills — 支持消息、文档、电子表格、日历、邮件、任务、会议等操作。

快速开始 在 GitHub 上查看
# 通过 npm 全局安装 Feishu CLI
$ npm install -g @larksuite/cli
$ npx skills add larksuite/cli -y -g
200+
CLI 命令
11
业务领域
19
AI Agent Skills
2,500+
API 端点
核心能力

为什么选择 Feishu CLI

Feishu CLI 连接 AI Agent 与企业生产力。每条命令均经过真实 Agent 测试,具有简洁的参数设计、智能默认值和结构化输出格式,最大限度提升自动化成功率。

Agent 原生设计

从底层为 Claude Code、Cursor、Codex 和 OpenCode 等 AI Agent 打造。19 个结构化 Skills 支持通过自然语言控制整个飞书平台,无需编写任何代码。

三层命令架构

快捷命令用于快速操作,API 命令用于精确控制,原始 API 访问覆盖全部 2,500+ 端点。根据每项任务选择合适的抽象层级。

结构化输出

支持 JSON、NDJSON、表格、CSV 或美化打印格式输出。内置 --page-all 分页功能,可配置页面限制,支持二进制文件输出。

🔒

企业级安全

基于操作系统原生密钥链的凭证存储、输入注入防护、终端输出净化,以及所有破坏性操作的 --dry-run 预览功能。

灵活认证

OAuth 2.0 设备流认证,支持用户和机器人身份切换。基于权限范围的访问控制,--recommend 自动选择最小权限。支持交互式 TUI 和无头 Agent 模式。

跨平台支持

可在 macOS、Linux 和 Windows 上运行,支持 x64 和 arm64 架构。使用 Go 语言构建,通过 npm 分发,自动安装平台专属二进制文件。

架构

三层命令体系

Feishu CLI 将命令组织为三个渐进层级,让人类和 AI Agent 可以在合适的抽象层级上操作。

1

快捷命令(推荐)

+ 为前缀的人类与 AI 友好命令。内置智能默认值、表格输出和 dry-run 预览。

lark-cli calendar +agenda   lark-cli im +messages-send --text "Hello"

2

API 命令

100+ 精选命令,从飞书 OAPI 元数据自动生成,与平台端点一一对应,实现精确控制。

lark-cli calendar events instance_view --params '{...}'

3

原始 API 访问

直接 HTTP 调用飞书开放平台 2,500+ API 端点中的任意一个。当快捷命令和 API 命令无法满足需求时,提供完全的灵活性。

lark-cli api GET /open-apis/calendar/v4/calendars

覆盖范围

11 大业务领域

Feishu CLI(Lark CLI)全面覆盖飞书平台的所有主要能力,从日常消息到复杂的多维表格操作。

💬

即时消息

10 个快捷命令 — 发送、回复、搜索、群组管理

📄

云文档

7 个快捷命令 — 创建、读取、使用 Markdown 更新

📊

多维表格

60 个快捷命令 — 表格、记录、字段、视图、仪表盘

📅

日历

4 个快捷命令 — 日程、事件、空闲/忙碌、时间建议

📧

邮件

11 个快捷命令 — 发送、回复、转发、分类、监控

任务

11 个快捷命令 — 创建、分配、完成、提醒

📁

云空间

3 个快捷命令 — 上传、下载、评论

📊

电子表格

7 个快捷命令 — 读取、写入、追加、查找、导出

📖

知识库

知识空间与文档节点管理

🎥

会议

2 个快捷命令 — 搜索记录、查询纪要

👤

通讯录

2 个快捷命令 — 搜索用户、获取资料

AI 集成

19 个内置 AI Agent Skills

Feishu CLI 内置 19 个结构化 Skill 定义,可与 Claude Code、Cursor、Codex、OpenCode 等 AI 编程助手原生集成。每个 Skill 教会 AI Agent 如何在特定领域使用 CLI。

Skill 分类 描述
lark-shared 核心 基础 Skill,被所有其他 Skill 自动加载。应用配置、认证、身份切换、权限管理和安全规则。
lark-im 消息 发送和回复消息、管理群聊、搜索消息历史、上传和下载媒体文件、表情回应和话题回复。
lark-doc 文档 使用 Markdown 语法创建、读取、更新和搜索云文档。支持媒体插入、下载和白板操作。
lark-base 数据 多维表格、字段、记录和视图的完整增删改查。数据聚合查询、仪表盘、工作流、角色和表单。
lark-sheets 数据 创建、读取、写入、追加、查找和导出电子表格数据。支持值渲染选项和异步文件导出。
lark-calendar 效率 日历事件管理,包括日程视图、创建含参会者的事件、空闲/忙碌查询和最佳时间建议。
lark-mail 通信 浏览、搜索、阅读、发送、回复和转发邮件。草稿管理、附件、文件夹标签和实时 WebSocket 邮件监控。包含防提示注入安全规则。
lark-task 效率 创建、更新、完成和重新开启任务。子任务、任务列表、成员分配、关注者、评论和可配置提醒。
lark-drive 存储 上传和下载文件、管理权限、添加文档评论,支持知识库 URL 解析。
lark-contact 通讯录 通过姓名、邮箱或手机号搜索用户。从组织通讯录中获取详细用户资料。
lark-wiki 知识 管理知识空间和文档节点。将知识库 token 解析为实际文档 token,用于跨模块操作。
lark-event 平台 通过 WebSocket 长连接进行实时事件订阅。NDJSON 输出,支持正则路由和 Agent 友好的紧凑格式。
lark-vc 会议 搜索历史会议记录,查询 AI 生成的会议纪要,包括摘要、待办事项、转录文本和章节。
lark-whiteboard 可视化 通过 DSL 或 Mermaid 语法渲染白板和图表。支持架构图、流程图、组织结构图、柱状图、折线图、漏斗图、思维导图等。输出为 PNG。
lark-minutes 会议 获取会议纪要元数据和 AI 产物,包括标题、时长、AI 生成的摘要、行动项和章节分解。
lark-openapi-explorer 平台 API 发现工具,当现有 Skill 无法满足特定需求时,引导 Agent 逐层探索飞书官方 OpenAPI 文档。
lark-skill-maker 平台 自定义 Skill 创建框架。提供模板和最佳实践,将 CLI 操作打包为可复用的 SKILL.md 文件。
lark-workflow-meeting-summary 工作流 编排工作流,收集指定时间范围内的会议纪要,并使用 vc +search 和 vc +notes 生成结构化摘要报告。
lark-workflow-standup-report 工作流 编排工作流,结合日历日程和任务列表,生成完整的每日站会或状态报告。
快速开始

3 步安装 Feishu CLI

在五分钟内启动并运行 Lark CLI。需要 Node.js 16 或更高版本,支持 macOS、Linux 或 Windows。

第 1 步:安装 CLI 和 AI Skills

# 全局安装 Feishu CLI 二进制文件
$ npm install -g @larksuite/cli

# 安装全部 19 个 AI Agent Skills
$ npx skills add larksuite/cli -y -g

第 2 步:配置和认证

# 初始化应用凭证(交互式设置)
$ lark-cli config init

# 使用推荐的最小权限登录
$ lark-cli auth login --recommend

# 验证一切正常
$ lark-cli auth status
$ lark-cli doctor

第 3 步:开始使用

# 查看今天的日历日程
$ lark-cli calendar +agenda

# 向群聊发送消息
$ lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello from Feishu CLI"

# 使用 Markdown 创建新文档
$ lark-cli docs +create --title "Weekly Report" --markdown "# Progress\n- Completed feature X"

# 列出我的任务
$ lark-cli task +get-my-tasks

# 查看任意 API 的参数和权限
$ lark-cli schema im.messages.create
实际应用场景

使用 Feishu CLI 可以构建什么

团队使用 Feishu CLI(Lark CLI)自动化工作流、优化沟通,并构建跨飞书平台所有服务的 AI 办公助手。

批量个性化消息

在一分钟内向所有团队成员发送定制消息。AI Agent 为每位接收者编写独特内容,并通过消息模块自动发送。

多维数据审计

扫描多维表格记录中的缺失字段、数据不一致和格式问题。自动通知相关负责人修复已发现的问题。

会议流程自动化

从会议纪要中提取行动项,创建跟进文档,向团队成员分配任务,并在一个自动化流程中发送通知消息。

跨时区日程安排

查询多位团队成员在不同时区的日历可用性,并使用空闲/忙碌和建议 API 推荐最佳会议时间。

每日简报生成

汇总监控数据、新闻资讯或内部报告,每天早晨向指定飞书群组推送结构化的每日简报。

邮件简历处理

监控收件箱中的简历附件,提取关键信息,将候选人整理到结构化的多维表格记录中,并发送确认邮件。

技术内幕

技术栈

Feishu CLI 采用经过验证的生产级开源技术构建。使用 Go 语言编写以保证性能,通过 npm 分发以方便获取。

编程语言 Go 1.23+,高性能与跨平台编译
CLI 框架 spf13/cobra v1.10.2,命令路由
终端 UI Charmbracelet(bubbletea、lipgloss、huh)
飞书 SDK larksuite/oapi-sdk-go v3.5.3(官方)
凭证存储 通过 go-keyring 使用操作系统原生密钥链
实时通信 通过 gorilla/websocket 实现 WebSocket
分发方式 npm 包封装 Go 二进制文件,通过 GoReleaser 构建
支持平台 macOS、Linux、Windows(x64 + arm64)
信任与安全

安全优先设计

Feishu CLI 实现了多层安全防护,在人类操作员和 AI Agent 使用时均能保障您的数据安全。

操作系统原生密钥链存储

凭证存储在 macOS 钥匙串、Windows 凭据管理器或 Linux Secret Service 中,绝不以明文保存。

输入注入防护

所有输入均经过验证和净化,防止命令注入攻击以及 AI Agent 场景下的提示注入。

Dry-Run 预览

在任何写操作上使用 --dry-run 可在执行前预览确切的 API 请求。对 AI Agent 安全至关重要。

最小权限范围

登录时使用 --recommend 标志自动选择常见操作所需的最小权限。

终端输出净化

所有终端输出均经过净化,防止 ANSI 转义序列注入和其他基于终端的攻击。

邮件防注入规则

邮件 Skill 将所有邮件内容视为不可信输入,并设有专门规则防止通过邮件正文进行提示注入。

深度指南

按主题探索 Feishu CLI

通过我们的详细指南深入了解 Feishu CLI 的各项功能,涵盖安装、AI 集成和各个业务领域。

安装与配置指南

安装 Feishu CLI 的分步说明,包括凭证配置、OAuth 认证和使用 lark-cli doctor 进行故障排查。

AI Agent Skills 参考

全部 19 个 AI Agent Skills 的完整指南。与 Claude Code、Cursor 和 Codex 集成,实现自然语言办公自动化。

消息与群聊

发送消息、管理群聊、搜索对话、回复话题,以及使用 10 个即时消息快捷命令下载媒体文件。

日历与日程安排

查看日程、创建事件、检查空闲/忙碌状态,以及通过日历模块获取 AI 驱动的会议时间建议。

文档操作

使用 Markdown 创建、读取和更新云文档。插入媒体、管理白板,以及跨内容类型搜索。

多维表格

60 个快捷命令,覆盖飞书多维表格中的表格、记录、字段、视图、仪表盘、工作流、表单和高级权限。

邮件管理

撰写、发送、回复、转发邮件。管理草稿、整理收件箱,以及使用 WebSocket 监控收件。

任务管理

创建和分配任务、设置提醒、管理子任务和任务列表。跟踪进度并与团队协作。

常见问题

常见问题解答

什么是 Feishu CLI?

Feishu CLI(也称为 Lark CLI)是字节跳动旗下飞书开放平台推出的官方开源命令行工具。它提供覆盖 11 大业务领域的 200+ 命令,包括消息、文档、日历、邮件、任务等。CLI 二进制文件名为 lark-cli,npm 包名为 @larksuite/cli。专为人类开发者和 AI Agent 设计,采用 MIT 许可证发布。

Feishu CLI 和 Lark CLI 有什么区别?

飞书和 Lark 是字节跳动旗下的同一产品。飞书是中文品牌名称,Lark 是国际品牌名称。Feishu CLI 和 Lark CLI 指的是同一个工具 — 即 lark-cli 二进制文件。它同时兼容飞书(feishu.cn)和 Lark(larksuite.com)平台账户。

Feishu CLI 是否支持 Claude Code 和 Cursor?

是的。Feishu CLI 内置 19 个 AI Agent Skills,可与 Claude Code、Cursor、Codex、OpenCode 等 AI 编程助手原生集成。通过 npx skills add larksuite/cli -y -g 安装 Skills 后,AI Agent 可以通过自然语言命令操控整个飞书平台。安装后请记得重启您的 AI 工具。

Feishu CLI 支持哪些平台和系统?

Feishu CLI 可在 macOS、Linux 和 Windows 上运行,支持 x64 和 arm64 架构。npm 安装需要 Node.js 16 或更高版本。CLI 使用 Go 语言构建,通过 npm 以平台专属二进制文件的形式分发。

Feishu CLI 如何处理认证?

Feishu CLI 使用 OAuth 2.0 设备流进行认证。登录时,它会提供一个 URL 用于浏览器授权。凭证安全存储在操作系统的原生密钥链中。该工具支持用户和机器人两种身份,可通过 --as 标志切换。

Feishu CLI 是否免费使用?

是的。Feishu CLI 采用 MIT 许可证开源,无任何使用费用。您需要一个飞书或 Lark 账户,并在飞书开放平台上创建自建应用以生成所需的 App ID 和 App Secret 凭证。飞书开放平台本身为大多数 API 提供免费额度。

三层命令架构是如何工作的?

第一层(快捷命令)提供以 + 为前缀的人类与 AI 友好命令,具有智能默认值和结构化输出。第二层(API 命令)与 100+ 精选平台端点一一对应。第三层(原始 API)可通过 lark-cli api 直接 HTTP 调用飞书开放平台 2,500+ API 端点中的任意一个。