飞书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这么干:

  1. 调用飞书视频会议的Skill,搜索今天的会议记录
  2. 获取飞书妙记的AI总结和待办事项
  3. 调用文档Skill创建一个新文档
  4. 把内容结构化整理后写入
  5. @相关同事发送通知

整个流程全自动。我开完会喝杯水的功夫,纪要就发出去了。

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办公自由!


相关链接