飞书CLI实操玩法分享
飞书官方刚开源的命令行神器,让你的AI助手直接操控飞书
就在前两天(2026年3月28日),飞书官方在GitHub上开源了一个叫 lark-cli 的命令行工具,当天就冲上了1000+ Star。
我一看介绍,好家伙,这玩意儿直接把飞书2500+个API封装成了200+条命令,还自带19个AI Agent Skills。意思就是:装完之后,Claude Code、Cursor这些AI工具可以直接用自然语言操作你的飞书——发消息、建文档、查日历、写多维表格,全都能干。
说干就干,我当天就给Claude code和openclaw(小龙虾主要是省token)装上试了试。一个字,爽!
飞书CLI是什么
简单来说,lark-cli 就是飞书开放平台的官方命令行工具。
以前你想用代码操作飞书,得自己去开放平台申请应用、配置权限、获取Token、调API……流程繁琐得要命。现在有了这个CLI,装上之后扫个码授权,AI助手就能直接帮你操作飞书了。
它覆盖了飞书的11个核心业务域:
| 业务域 | 能干啥 |
|---|---|
| 日历 | 查日程、建会议、查忙闲状态、推荐开会时间 |
| 即时通讯 | 发消息、回复消息、管理群聊、搜索历史消息 |
| 云文档 | 创建/读取/更新文档,Markdown无缝转换 |
| 多维表格 | 增删改查记录、数据分析、生成仪表盘 |
| 电子表格 | 读写单元格、批量追加数据 |
| 邮箱 | 发邮件、批量定制化邮件 |
| 任务 | 创建任务、指派负责人、设置提醒 |
| 会议 | 管理视频会议 |
| 知识库 | 查询文档、管理知识库结构 |
| 文件管理 | 上传下载、管理分享权限 |
| 通讯录 | 查询用户信息 |
命令分三层:第一层是快捷命令(带+前缀),日常够用;第二层是API命令,跟飞书开放平台一一对应;第三层是原始API调用,覆盖全部2500+个接口。
普通人用第一层就够了,AI Agent一般用第二层,想做骚操作再上第三层。
我的实操玩法
1. 一句话查今日日程
以前我要看今天有什么会,得打开飞书App→点日历→滑来滑去。
现在直接跟Claude Code说”帮我看看今天有什么会”,它调一下CLI命令:
lark-cli calendar +agenda几秒钟就把今天的日程列出来了。如果想看下周的,加个参数就行:
lark-cli calendar +agenda --next-week还能玩管道组合,比如想知道下周跟张三有几个会:
lark-cli calendar agenda --next-week | grep "张三" | wc -l一行命令搞定,谁懂这种快感。
2. 自然语言约多人会议
这个是真的让我惊到了。
以前约一个五人会议,得一个个问”你那天有空吗”,然后手动找大家都空闲的时间段。
现在直接跟AI说”帮我约一个下周的会,参会人是张三、李四、王五,找一个大家都有空的时间”。
AI会自动去查每个人的日历和时区,推荐几个时间段,你选一个,会就建好了。邀请也自动发出去。
这套流程以前至少要来回沟通半小时,现在一分钟搞定。
3. 会议纪要自动整理
开完会最烦的事情是什么?整理会议纪要。
现在可以让AI这么干:
- 调用飞书视频会议的Skill,搜索今天的会议记录
- 获取飞书妙记的AI总结和待办事项
- 调用文档Skill创建一个新文档
- 把内容结构化整理后写入
- @相关同事发送通知
整个流程全自动。我开完会喝杯水的功夫,纪要就发出去了。
4. 多维表格数据沉淀
我之前一直用飞书多维表格做选题库(就是用我自己做的一个 feishu-topic-library Skill,专门把社媒的文章链接发给飞书小龙虾,然后他自动给我沉淀到选题库)。
现在有了官方CLI,可以玩更骚的操作了。比如让AI:
- 拉取过去两周的日历数据
- 自动给每场会议打标签(内部沟通/外部对接/一对一等)
- 写入多维表格
- 生成饼图和柱状图
或者把公司的项目管理表格扔给AI,让它检查有没有漏填的字段,自动给相关同事发提醒。
为什么选飞书CLI
你可能会问:之前不是已经能用API操作飞书了吗?这个CLI有啥特别的?
几个关键点:
1. 官方出品,开箱即用
以前用第三方库或者自己封装API,总担心哪天接口变了就挂了。现在官方亲自下场,MIT协议开源,稳定性有保障。
2. AI友好设计
这个CLI从一开始就是为AI Agent设计的。出错时会告诉Agent具体缺了什么权限、怎么补;支持JSON/table/CSV多种输出格式;还支持Schema自省,Agent可以先查API的参数结构再调用。
3. 权限一键授权
以前配置飞书应用权限是个大坑,各种scope看得头晕。现在 lark-cli auth login --recommend 一键授权常用权限,小白也能搞定。
4. 跟现有AI工具无缝集成
装完CLI再装一下Skills(npx skills add larksuite/cli -y -g),Claude Code、Cursor、Codex这些工具就能直接调用了。不用自己写任何对接代码。
新手避坑指南
玩了几天,踩了一些坑,分享给你们避免重蹈覆辙:
1. 安装完Skills必须重启Claude Code
很多人装完CLI和Skills之后发现AI识别不到,以为安装失败了。其实只是没重启。重启一下Claude Code就好了。
2. 不要只说”装飞书CLI”
如果你直接跟AI说”帮我装飞书CLI”,它可能只装CLI本体,不装Skills。建议直接发这个Prompt:
帮我装一下所有的东西:https://github.com/larksuite/cli/blob/main/README.zh.md
这样AI会把CLI和Skills都装上。
3. 注意安全风险
官方文档里专门提了:这个工具可以被AI Agent调用,存在模型幻觉和提示词注入的风险。授权之后,AI是以你的身份在操作飞书的。
所以:
- 不要给AI过多的权限,用
--recommend就够日常使用了 - 重要操作前让AI先
--dry-run预览一下再真正执行 - 定期检查一下AI都帮你干了啥
4. 国际版Lark也能用
如果你用的是国际版Lark而不是国内飞书,在 config init 的时候选择国际版应用就行,CLI都支持。
怎么开始
三步上手,真的很简单:
第一步:安装
# 安装CLI
npm install -g @larksuite/cli
# 安装Skills(必须装!)
npx skills add larksuite/cli -y -g第二步:配置和授权
# 初始化配置(会弹出二维码,用飞书扫码)
lark-cli config init
# 一键授权常用权限
lark-cli auth login --recommend第三步:验证安装
# 查看授权状态
lark-cli auth status
# 试试查日程
lark-cli calendar +agenda如果能看到你的日程,说明安装成功了。
然后重启一下Claude Code,跟它说”帮我看看今天有什么会”,它应该就能调用飞书CLI了。
写在最后
飞书CLI的开源,其实反映了一个趋势:AI Agent时代,大家都在做命令行工具。
为什么?因为CLI是AI和软件系统之间最自然的接口。AI擅长处理文本,CLI的输入输出都是文本,天然适配。
以前我们用飞书,是人去操作界面;现在有了CLI,AI可以直接帮我们操作飞书。这不是简单的效率提升,而是工作方式的根本改变。
想象一下:以后你开完会,随口说一句”龙虾龙虾,帮我把这个方案整理成文档发给老板”,AI就从会议录音里提取内容、整理成文档、发送通知,全自动完成。
这个未来已经不远了。
趁现在飞书CLI刚开源,赶紧装上玩起来,把你的AI助手武装起来。等别人还在手动复制粘贴的时候,你已经让AI帮你干完活了。
加油,祝你早日实现AI办公自由!
相关链接: