给想让 AI 动手干活的人的实用指南

飞书 CLI
是什么?

飞书 CLI(命令行里的 lark-cli)是飞书官方开源的终端客户端:一行命令读消息、写文档、查日历、建多维表格——它也是 AI Agent 操作飞书的那双手。

比如,在终端输入一条命令,把会议纪要直接写成一篇飞书文档;或者对 Claude Code 说一句"把本周评审意见整理成周报,发到项目大群",它通过 CLI 在飞书里把事办完——你只管看结果。

larksuite 官方 · MIT 开源 覆盖 18 大业务域 GitHub 17k+ Star macOS / Windows / Linux
terminal — zsh

体验一个任务

挑一件事,看命令长什么样

这些写法都来自官方文档与 README,思路可以在你自己的终端里原样运行。点左侧任务,右侧终端会跟着切换。

lark-cli — 演示
LAYER 1 · 最顺手

快捷命令 +

高频动作的一行式封装,参数少、默认值聪明,比如 im +messages-send、docs +create、calendar +agenda。

LAYER 2 · 最全面

API 命令

由开放平台 OpenAPI 元数据生成,覆盖 18 个业务域的全部接口,参数即文档,配合 --help 就能查。

LAYER 3 · 最彻底

通用调用 lark-cli api

任何开放平台接口都能直调:方法 + 路径 + 参数,路径与官方 OpenAPI 完全一致,2500+ 接口尽收其中。

大家正在用 CLI 做什么

把重复劳动交给命令

三个最常见的自动化场景。它们是社区里的典型玩法,具体效果取决于你的权限范围与配置。

消息摘要定时

群消息 → 每日简报

每天早上让 Agent 读一遍项目群,把阻塞项、结论和待办整理成一份摘要,发回给你或写进文档。信息不再靠爬楼。

命令雏形 → im 读消息 + docs 写简报 + cron 定时
文档协作

周报自动写进飞书

从任务列表、多维表格里取数,让 AI 起草周报,用一条命令生成文档,再把链接丢回大群——周五下午省出一杯咖啡的时间。

命令雏形 → docs +create --doc-format markdown
日历会议

面试排期不拉扯

查面试官本周空档、建视频会议、发日程邀请,一条流水线跑完。HR 不用再在三个日历之间来回对时间。

命令雏形 → calendar +agenda + vc 建会 + 发邀请

以上为社区常见玩法,本站未复测 · 动手前建议先加 --dry-run 预览会发生什么。

为什么是命令行

以前是你操作飞书,
现在是 AI 操作飞书,你只管拍板。

官方文档的比喻很直白:AI Agent 看不到你的日历,读不了你的群聊,打不开你的文档——飞书 CLI 就是给 Agent 的那双手。它把两百多个飞书操作封装成稳定的文本接口:输入是命令,输出是结构化 JSON,任何能开终端的 AI 都能用。

01

为 Agent 而生

26 个官方 Agent Skills 开箱即用,Claude Code、Cursor、Codex、TRAE 装上就能用;命令本身做过"AI 友好"实测调优。

02

机器可判断

JSON 输出契约:成功与否看 ok == true,错误信封走 stderr,Agent 不用猜测界面截图里发生了什么。

03

先看再执行

--dry-run 预览、schema 自省、分页与限速参数,把危险操作挡在真正发生之前。

依据与事实

它到底是什么

出身
larksuite 团队官方维护2026 年开源,MIT 协议,更新非常勤(npm 已发布 100+ 个版本)
形态
Go 编写的单文件二进制npm 分发(@larksuite/cli),也可以克隆源码自己构建
覆盖
18 大业务域 · 200+ 命令另有 2500+ 个开放平台接口可通用调用
双端
中文飞书 & 国际版 Lark同一套命令,两个版本都能登录使用
双身份
--as user / --as bot以"你"的身份读写个人资源,或以"应用"身份干公共的活
配套
26 个 Agent Skills消息、文档、表格、日历、邮箱、审批……另有企业级扩展支持

你需要提供什么

STEP 1 · 10 秒

装上它

一条 npm 命令,装完自动配好补全。需要 Node.js 18+ 环境;没有 Node 也可以克隆 Go 源码构建。

❯npx @larksuite/cli@latest install
STEP 2 · 约 5 分钟

配一次,用很久

首次使用初始化配置并授权。凭证会被放进操作系统原生密钥链,之后所有命令直接可用。

❯lark-cli config init
❯lark-cli auth login --recommend

不想授权个人数据?也可以直接用:仍能发消息、建文档,只是读不了你的日历和私信;等 AI 真需要时会自动发起授权提示,你在手机上点一下确认即可。应用与权限始终遵循企业开放平台的统一管控规则。

安全边界在哪里

  • 凭证不落明文——App Secret 与令牌保存在 macOS Keychain / 凭据管理器等系统密钥链里。
  • 令牌默认 DPoP 绑定——即使 token 泄露也难以被冒用,可用 config set dpop 调整级别。
  • 输入防注入、输出净化——终端内容经过清洗,降低提示词注入被带进 Agent 上下文的风险。
  • 最小授权——按业务域授权(如 auth login --domain docs),用不到的权限不开。
  • 企业管控不打折——CLI 只是一键创建应用,权限审批、审计仍走企业开放平台的原有流程。
  • 可预览可撤销——--dry-run 先看后跑,auth logout 随时下线本机登录态。

官方的诚实提醒:工具本身做了不少防护,但模型幻觉与提示词注入的风险仍然存在。官方建议把对接的机器人当作私人助手使用,不要拉进群聊;给 AI 的权限够用就好。

接下来继续了解

常见问题

飞书 CLI 免费吗?+
工具本身 MIT 开源、完全免费。使用需要一个飞书"企业自建应用",在开放平台创建应用不收费,lark-cli config init 还能一键帮你创建。API 调用消耗的是应用自身的频率配额,个人与中小团队场景完全够用。
需要企业管理员审批吗?+
取决于企业设置:创建应用通常人人可以,但开通敏感权限(读私聊、通讯录等)时,部分企业会要求管理员审核。权限不足时 CLI 会在报错里直接给出 console_url,按提示去开发者后台补开即可。
它和飞书机器人是什么关系?+
机器人是飞书里"会说话的应用",CLI 是操作飞书的"手柄",两者常常配合:机器人收指令,CLI 办事情。CLI 支持两种身份——--as user 以你本人的身份读写你的日历和文档,--as bot 以应用身份收发消息、操作应用自己的资源。
它和 MCP 是什么关系?+
MCP 是让 AI 接工具的通用协议,飞书 CLI 则是官方做好的"现成实现":鉴权、schema 自省、JSON 输出契约、Agent Skills 都已内置。官方在 OpenClaw 等平台上的飞书插件,底层也是基于这套 CLI 构建的。对个人用户来说,装上 CLI 基本等于跳过自建 MCP 服务的那一整套调试。
我的账号安全吗?+
CLI 在本机运行:凭证进系统密钥链、令牌默认 DPoP 绑定、不经过第三方服务器。风险主要来自把过大的权限交给 AI——官方明确提醒警惕模型幻觉与提示词注入。建议按业务域最小授权、先 --dry-run 再执行,并优先作为私人助手使用。
支持 Windows 和国际版 Lark 吗?+
支持。macOS / Windows / Linux 都有官方二进制,通过 npm 一行安装;中文飞书与国际版 Lark 都能登录使用。工具迭代很勤,截至本页整理时 npm 上已发布 100+ 个版本。

它适合谁

四类人,四个起点

For Developers

开发者

把 OpenAPI 写进脚本、CI 和内部工具,不用再手写鉴权和 token 管理,2500+ 接口即取即用。

起点 → lark-cli help
For Ops

行政 / 运营

批量发通知、收集表催办、把 Excel 变成多维表格——交给 AI 一句话,终端里跑完。

起点 → im +messages-send
For Leads

团队负责人

周报、站会纪要自动成文并发回群里,信息同步不再靠人催、靠人记。

起点 → docs +create
For AI Players

AI 玩家

给 Claude Code、Cursor 装上飞书的双手,26 个官方 Skills 装完即用,让 AI 真正"进群干活"。

起点 → npx skills add larksuite/cli

开始使用

试着敲出第一条命令

装好之后,把下面这行交给你的 AI 去跑——或者,你自己跑。

❯ npx @larksuite/cli@latest install
微信公众号「大话数据分析」二维码

微信扫码关注「大话数据分析」数据 · 分析 · AI 实战