← → 翻页 · B 静态 · ESC 索引
Product Brief · 2026
Vol.01
官方开源 · lark-cli

飞书 CLI

给 AI Agent 的「双手」

装上之后,AI 可以直接读消息、查日历、写文档、建多维表格——而不是只生成一段让你复制粘贴的文字。

能力介绍与最佳实践·约 15 分钟读完即上手
github.com/larksuite/cli
— 01 / 14 —
Hook · 一句话
02 / 14
The Shift
以前是你操作飞书; 现在是 AI 操作飞书, 你只管拍板。

你不需要学会每一条命令。用自然语言跟 AI 说话,AI 用 CLI 去操作飞书。

核心价值主张
— · —
Context · 理解方式
03 / 14
三人群聊

飞书终于进了群

Before · 缺通道

你 ↔ AI

  • 你发消息 = 跟 AI 说话
  • AI 只能给建议与草稿
  • 飞书不在群里,没有「手」
  • 结果:复制粘贴、手工点点点
After · 飞书入群

你 ↔ AI ↔ 飞书

  • AI 执行命令 = 跟飞书说话
  • 飞书返回结果 = 回复你们俩
  • CLI 把飞书拉进对话
  • 结果:查日历、写文档、建表真干活
CLI 是通道,不是又一门课
Before / After
Audience · 谁会用
04 / 14
四种入口

几乎人人可接

General AI
Trae / Cursor
装 CLI + Skills,让 AI 代操作:总结、整理群聊、更表
Enterprise Agent
企业 Agent
官方推荐接入方式;用户身份 + 应用身份覆盖核心域
OpenClaw
官方插件
一句话完成安装(以官方插件说明为准)
飞书 aily
内置能力
一般无需单独安装(以产品实际能力为准)
零基础同学 + 研发团队都适用
— · —
Setup · 准备工作
05 / 14
Checklist

开工前五件事

01
联网电脑
macOS / Windows / Linux
02
飞书客户端
已安装并登录
03
开放平台
企业允许自建应用
04
AI 工具
Trae / Cursor / Codex…
05
配置授权
应用配置 + 可选用户授权
Mindset
装一次
之后可以「忘了它」
有管控先问管理员
— · —
Install · 快速安装
06 / 14
一行命令 · 五分钟

从安装到第一条指令

安装 · Install
01
Install
npx @larksuite/cli@latest install
02
Verify
lark-cli -v 看到版本号
03
Config
config init · 新应用或已有应用
授权 · Auth
04
Login
auth login · 最小权限按需开
05
Doctor
doctor / whoami / auth status
06
Restart
重启 AI 工具加载 Skills
密钥禁止发群 / 文档 / 日志明文
按 → 逐步点亮
Act I · First Win
07 / 14
第一条有效指令

先让 AI 建一篇文档

「帮我创建一篇云文档,介绍飞书 CLI 的能力有哪些,以及基于你对我的了解,我可以先开始用哪些能力。」

预期结果:AI 通过 CLI 在飞书创建文档,并返回可打开的链接。
— 安装完成的验收标准
读完本文应能完成安装并发出第一条指令
— · —
Act II · Scenarios
08 / 14
Act II

能做什么

五个高频场景。你只说自然语言,AI 自己调 CLI——无需手写复杂命令。

来自官方最佳实践
— · —
Scenarios · 01–02
09 / 14
会后落地 · 文档共创

从说到做,不离开飞书

场景 1

开完会,事就办了

AI 从妙记识别待办:发文档、约 follow-up、做调研——执行前先给你看计划。

读这个妙记,提取待办并帮我办了。做之前给我看计划。
场景 2

人与 AI 共创文档

A 起草你把关 · B 你写 AI 审稿(只评论)· C Markdown 无缝转飞书文档。

根据评论修改文档,并用划词评论标识修改点。
执行前先看计划 · 默认先私信审核
— · —
Scenarios · 03–05
10 / 14
日程 · 审计 · 邮件

把协作交给 Agent

场景 3
智能约会
拉群成员、查空闲、跨时区推荐时段,你选一个就建会
场景 4
会议审计
日历打标写多维表 + 仪表盘;妙记产出密度,砍低效会
场景 5
邮件处理
未读分类、重要摘要、低优先归档,并起草回复草稿
涉及「发到群」时,确认范围与敏感度;团队默认优先发审核人私信。
— 本团队安全约定
自然语言即可触发
— · —
Why · 为什么选它
11 / 14
Four Pillars

不只是 API 包装

01 Context + Hands
有上下文
消息、文档、日历、妙记、多维表——能拿上下文并直接动手
02 Agent-Native
为 AI 设计
出错提示怎么修,缺权限引导补授权,形态适合 Agent 调用
03 Open Source
开源接入
Codex / Cursor 等能跑命令行即可;无需额外登记门槛
04 Full Surface
域全迭代快
IM、文档、表格、日历、会议、邮箱、任务、知识库、审批…
用户身份 + 应用身份双轨
— · —
Concepts · 核心术语
12 / 14
Glossary

六个词就够用

lark-cli

官方命令行;AI 用它操作飞书。

--as user

以你本人权限访问个人日历、云盘、私信。

--as bot

机器人名义;默认看不到个人云空间。

业务域

门禁分区:docs / im / calendar… 最小权限。

+ 快捷命令

如 docs +create、im +messages-send,优先用。

Skills

与 CLI 版本匹配的 Agent 操作说明,避免旧文档漂移。

user / bot 不是强弱,是场景
— · —
Surface · 业务域
13 / 14
Coverage Map

核心业务面一览

IM
消息群组
搜索 / 发送 / 话题 / 文件
Docs
云文档
创建 / 读写 / 插图
Drive
云空间
上传下载 / 权限
Sheets / Base
表格多维表
单元格 · 记录 · 仪表盘
Calendar / VC
日历会议
约会 · 妙记 · 纪要
Mail / Task…
邮件任务
+ 知识库 / 审批 / OKR

完整列表以本机 lark-cli --help 为准。高风险写操作:先 dry-run → 真人确认 → 再 --yes。

禁止脚本默认带 --yes
— · —
Closing · Next Step
14 / 14
Takeaway

装一次 CLI,
把飞书交给 Agent。

安装 → 授权 → 重启 AI 工具 → 发出第一条建文档指令。之后你只负责拍板。

github.com/larksuite/cli·lark-cli doctor / help
键盘 ← → · ESC 索引 · B 静态
— End —