飞书开源CLI工具lark-cli测评：200+命令与19个AI技能全解析

说实话，飞书官方推出的 lark-cli 在开发者圈子里确实引发了不少关注。它并非第三方封装，而是由 larksuite 团队直接维护的开源命令行工具，采用 MIT 协议，覆盖消息、文档、多维表格、电子表格、日历、邮箱、任务、会议等 11 个核心业务域，提供超过 200 条命令和 19 个内置 AI Agent Skills。一句话总结：你和 AI 都能直接在终端里操控飞书，告别频繁切到网页或客户端。

lark-cli 是什么

lark-cli 是飞书官方出品的开源 CLI 工具，同时面向人类用户和 AI Agent。

与那些非官方的飞书 SDK 不同，lark-cli 由官方团队持续维护，命令会同步飞书开放平台的 API 更新。它的设计理念非常清晰：三层调用架构，从快捷操作到完整 API 调用，层层递进。

三个核心数字：

• 11 大业务域：日历、即时通讯、云文档、云空间、多维表格、电子表格、任务、知识库、通讯录、邮箱、视频会议
• 200+ 条命令：全部经过 Agent 实测，参数设计对 AI 调用非常友好
• 19 个 Agent Skills：开箱即用，兼容 Claude Code、Cursor、Gemini CLI 等主流 AI 工具

三层命令架构详解

lark-cli 的命令系统分三层，按操作粒度从粗到细：

快捷命令是日常高频首选，+ 前缀让 AI 模型能轻松识别并调用；通用调用则是兜底方案——飞书开放平台的任意接口都能直接调用，无需等待 CLI 更新。

安装与快速上手（3 分钟）

环境要求

• Node.js（提供 npm/npx）
• Go v1.23+（仅从源码构建时需要）

安装

# 安装 CLI 主体
npm install -g @larksuite/cli

# 安装 CLI Skills（必须）
npx skills add larksuite/cli -y -g

配置与登录

# 第一步：配置应用凭证（交互式引导，仅需一次）
lark-cli config init

# 第二步：登录授权（--recommend 自动勾选常用权限）
lark-cli auth login --recommend

# 第三步：验证
lark-cli auth status

第一条命令

# 查看今日日程
lark-cli calendar +agenda

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

# 创建文档
lark-cli docs +create --title "周报" --markdown "# 进展\n- 完成功能 X"

19 个 AI Agent Skills 清单

lark-cli 最亮眼的特色之一就是这 19 个内置 Agent Skills。安装后，在 Claude Code、Cursor、Gemini CLI 等工具中可直接调用：

lark-shared 是基础 skill，会被其他所有 skill 自动加载，无需手动引用。

在 Claude Code 中直接操控飞书

安装 lark-cli 并配置好 Skills 后，在 Claude Code 会话中直接用自然语言触发飞书操作，比如：

# 让 Claude Code 发送每日站会提醒
把今天的待办任务汇总后发到飞书群 oc_xxx

# 自动创建会议纪要文档
把刚才的会议录音转写成文档，保存到飞书知识库"产品设计"空间

Claude Code 会自动匹配 lark-im、lark-task、lark-doc 等对应 Skill，调用底层命令完成操作。

AI Agent 安装流程（Claude Code 可直接执行）：

# 第 1 步：安装
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g

# 第 2 步：配置凭证（后台运行，输出授权 URL 给用户在浏览器完成）
lark-cli config init --new

# 第 3 步：登录
lark-cli auth login --recommend

# 第 4 步：验证
lark-cli auth status

进阶用法

多格式输出

--format json      # 完整 JSON（默认）
--format pretty    # 人类友好格式
--format table     # 表格视图
--format ndjson    # 换行分隔 JSON（适合管道处理）
--format csv       # CSV 格式

自动分页

--page-all          # 自动翻页获取全部数据
--page-limit 5      # 最多 5 页
--page-delay 500    # 每页间隔 500ms

Dry-Run 预览

对有副作用的操作（发送消息、创建文档等），先用 --dry-run 预览请求内容，确认无误再执行：

lark-cli im +messages-send --chat-id oc_xxx --text "hello" --dry-run

身份切换

同一环境中以不同身份执行命令：

lark-cli calendar +agenda --as user   # 以用户身份
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"  # 以机器人身份

Schema 自省

查看任意 API 方法的参数、请求体、响应结构、支持的身份和权限范围：

lark-cli schema
lark-cli schema calendar.events.instance_view
lark-cli schema im.messages.delete

安全风险说明

lark-cli 官方在 README 中单独列出了安全警告，使用前务必了解：

• AI Agent 调用此工具时，以用户授权的身份在飞书平台执行操作，可能导致敏感数据泄露或意外操作
• 不要将关联的飞书机器人加入群聊，或允许其他用户与之交互，防止权限滥用
• 凭证通过 OS 原生密钥链存储，内置输入防注入和终端输出净化

建议用最小权限原则配置 OAuth 授权范围（--scope 参数指定具体权限），不要无差别授权。

常见问题

Q：lark-cli 和飞书官方 MCP Server 有什么区别？
lark-cli 是命令行工具，通过 AgentSkills 格式与 AI 集成；MCP Server 是基于 Model Context Protocol 的服务进程，通过 JSON-RPC 与 AI 通信。两者定位互补：lark-cli 更轻量、开箱即用、无需常驻进程；MCP Server 适合需要实时事件订阅或更复杂状态管理的场景。lark-cli 也内置了 lark-event skill，支持 WebSocket 实时事件。

Q：Skills 和 CLI 命令是什么关系？
CLI 命令是底层执行单元，Skills 是告诉 AI Agent“何时调用哪些命令”的操作说明书。安装 Skills（npx skills add larksuite/cli -y -g）之后，AI 才能通过自然语言匹配并调用正确的 CLI 命令；不安装 Skills 也可以手动执行 CLI 命令，只是无法自动化。

Q：需要飞书管理员权限才能使用吗？
不需要。lark-cli 使用飞书开放平台的 OAuth 授权，以普通用户身份登录即可使用个人权限范围内的功能。企业应用场景（如批量操作用户数据）需要管理员审批相应权限。

Q：命令执行失败，提示权限不足怎么办？
用 lark-cli auth check --scope "<权限名>" 确认当前授权范围，再用 lark-cli auth login --scope "<权限名>" 补充授权。lark-cli schema <命令> 可查看该命令所需的具体权限。

Q：lark-cli 支持 Lark（国际版）和飞书（国内版）吗？
支持。lark-cli config init 配置时可选择域区（国内版/国际版），二者使用相同的命令集，无需分别安装。

结语

lark-cli 将飞书开放平台的 2500+ API 系统性地整理为 200+ 精选命令和 19 个 Agent Skills，填补了飞书生态在“可被 AI Agent 直接调用”方面的空白。对于需要将飞书深度融入 AI 工作流的开发者，这无疑是目前覆盖最广、官方维护、开箱即用的方案。

本文基于 larksuite/cli 仓库 README（2026 年 4 月版），建议结合官方仓库获取最新命令列表。

延伸资源

• larksuite/cli GitHub 仓库
• 飞书开放平台
• AgentSkills 开放标准规范