← → 翻页 · B 静态 · ESC 索引
飞书 CLI · Field Note 01
SS · 26.07.16 · 01 / 12
LARK-CLI · AGENT HANDS

给 AI 装上
飞书的双手

飞书 CLI 让 Agent 直接读消息、写文档、查日历、建表格——你只管拍板。
github.com/larksuite/cli
→ swipe / arrow keys
02 / 12
CONTEXT
THE TRIO

你跟 AI 的对话
不是私聊,
三人群聊

CLI 把飞书拉进群聊
HOW IT WORKS
CHANNEL
01 · You

用自然语言下指令

02 · AI

调用 lark-cli 操作飞书

03 · Feishu

返回结果,闭环协作

以前飞书不在群里——AI 只能给建议。装上 CLI 后,AI 能直接干活。

Audience · Who
03 / 12
Four roles · One CLI

谁会用到它

01
通用 AI 用户
Trae / Cursor / Codex 装 CLI + Skills,让 AI 代操作飞书。
02
企业 Agent 团队
官方推荐接入方式,覆盖核心业务域,支持 user / bot。
03
OpenClaw 用户
官方插件底层基于 CLI,一句话完成安装与能力对齐。
04
飞书 aily
已内置 CLI 能力,一般无需单独安装。
05
终端用户
直接跑 doctor / agenda / docs,验证环境与权限。
06
你不需要学命令
自然语言对 AI 说话;安装授权一次,之后可「忘掉」CLI。
Before / After
04 / 12
Shift · The channel opens

通道打开前后

A Before
只能建议

飞书不在对话里。AI 再聪明,也只能输出可复制粘贴的文字。

  • 你手动复制命令结果
  • 日历 / 文档 / 消息各自割裂
  • Context 靠你口述补全
B After
直接动手

CLI 把飞书拉进三人群聊。AI 读上下文、写产物、推流程。

  • 查日历 · 发消息 · 写文档
  • 多维表格 · 妙记 · 邮件
  • 你只做确认与拍板
Setup · 5 steps
05 / 12
Install path

五分钟就绪

推荐:npx @larksuite/cli@latest install · 验证 lark-cli -v

01
Install
npx / npm
02
Config
config init
03
Auth
login · domain
04
Doctor
health check
05
First task
docs +create
Scenarios · Playbook
06 / 12
Natural language · Zero hand-written cmds

四个立刻能用的场景

— 01 / Meet

会后即办

读妙记提取待办:发文档、约 follow-up、做调研;执行前先给计划。

— 02 / Doc

共创文档

AI 起草 / 你审稿 / Markdown 导入。评论闭环不离开飞书。

— 03 / Meet+

智能约会

拉群成员、查空闲、跨时区推荐时段,你选一个就建会。

— 04 / Audit

会议审计

日历打标进多维表格仪表盘;妙记产出密度,辅助砍低效会。

Docs · Co-create
07 / 12
Three modes

人与 AI
共创文档
的三种姿势

Stay in Feishu
01
AI 起草 · 你把关
建初稿 → 你评论 → AI 改正文。全程不离开飞书。
02
你起草 · AI 审稿
不改正文,只划词评论:清晰、简洁、对外可读性。
03
Markdown 无缝导入
高亮块、表格、代码块尽量保留,一键成飞书文档。
Concepts · Core
08 / 12
Identity · Scope · Shortcut

三个必须搞清的概念

LAYER 01
用户身份
--as user:以你本人权限访问日历、云盘、私信等个人资源。
personal context
LAYER 02
应用身份
--as bot:以机器人名义操作;默认看不到你的个人云空间。
app / bot
LAYER 03
快捷命令 +
docs +create、im +messages-send 等官方封装,优先于原生 API。
shortcuts first
Domains · Coverage
09 / 12
Core business domains

覆盖你日常的核心域

消息与群组
搜索、发送、话题、成员、表情、文件
云文档 / 云空间
创建更新、导入导出、权限与评论
表格 / 多维表格
单元格、记录、视图、仪表盘、自动化
日历 / 会议 / 妙记
约会议、忙闲、纪要、逐字稿、待办
邮箱 / 任务
未读分类、草稿回复、清单协作
知识库 · 审批 · OKR
节点层级、审批流、目标进展;以本机 help 为准
Statement
10 / 12
ONE RULE

你完全不需要
学会每一条命令。

用自然语言跟 AI 说话。AI 自己用 CLI 操作飞书。安装与授权一次,之后可以忘掉它。

Why Feishu CLI
11 / 12
Why choose it

为什么是飞书 CLI

Context + Hands

补齐上下文与手

消息、文档、日历、妙记、多维表格——能读能写,不只是口头建议。

01
Agent-native

为 AI 而设计

出错提示怎么修,缺权限引导补授权,命令形态适合 Agent 调用。

02
Open + Fast

开源 · 覆盖全

能跑命令行即可接入;消息到审批等多业务域持续迭代。

03
12 / 12
CLOSING
MANIFESTO

装一次。
说人话。
让 AI 动手

第一条指令:让 AI 用 CLI 创建一篇介绍飞书 CLI 能力的云文档。
larksuite/cli
26.07.16
TAKEAWAYS
03 RULES
01

安装 + 授权一次

config init · auth login · doctor · 重启 AI 工具加载 Skills。

02

分清 user 与 bot

不是强弱,是场景。用错常出现「成功但结果是空」。

03

先审后发 · 高风险门禁

群消息先私信审核;写操作 dry-run → 确认 → 再 --yes。

→ 完 · END OF FIELD NOTE