飞书 CLI:让 AI 操作你的飞书
飞书 CLI 是飞书官方开源的命令行工具,一条命令安装,扫码授权,就能在终端中操作飞书的消息、文档、日历、表格等一切功能。更是 AI Agent 的飞书操控引擎。
飞书 CLI:让 AI 操作你的飞书
飞书是国内企业最常用的协作平台之一。飞书 CLI(lark-cli)是飞书官方开源的命令行工具,它把飞书 2500+ 个 API 封装成了 200+ 条简洁命令,让 AI 和你都能在终端中直接操作飞书。
飞书 CLI 能做什么
| 操作 | 在飞书界面 | 用 CLI |
|---|---|---|
| 发消息 | 打开飞书,找到群,打字发送 | lark-cli im +send --text "你好" |
| 查日程 | 打开日历,翻看今天安排 | lark-cli calendar +agenda |
| 建文档 | 新建文档,手动排版 | 一条命令创建并写入 Markdown |
| 操作多维表格 | 在界面中逐行编辑 | 批量增删改查,还能做数据分析 |
覆盖 11 大业务域:消息、云文档、多维表格、电子表格、日历、邮件、任务、知识库、通讯录、视频会议、妙记。
三步安装
# 第一步:全局安装
npm install -g @larksuite/cli
# 第二步:安装 AI Skills(让 AI 工具也能调用)
npx skills add larksuite/cli -y -g
# 第三步:扫码授权
lark-cli config init
第三步会弹出二维码,用飞书扫码确认即可。推荐使用 --recommend 参数自动申请常用权限:
lark-cli config init --recommend
安装完成后跑 lark-cli doctor 检查状态,全绿就可以开始用了。
三层命令架构
飞书 CLI 设计了三层命令,由简到深:
| 层级 | 说明 | 示例 |
|---|---|---|
| 快捷命令(推荐) | 以 + 为前缀,简单好记 | lark-cli im +send |
| API 命令 | 100+ 精选命令,精确控制 | lark-cli calendar events list |
| 原始 API | 直接调 2500+ 飞书接口 | lark-cli api GET /open-apis/... |
日常使用主要用快捷命令就够了。
常用命令速查
# 查看今日日程
lark-cli calendar +agenda
# 发消息到群聊
lark-cli im +send --text "项目进展已更新"
# 创建飞书文档
lark-cli doc create --title "会议纪要" --body "# 今日讨论\n- 议题一\n- 议题二"
# 读取飞书文档
lark-cli doc read --url "飞书文档链接"
# 查看我的任务
lark-cli task +list
# 搜索消息
lark-cli im +search --query "周报"
AI Agent + 飞书 CLI 的玩法
飞书 CLI 最厉害的地方是:它天生就是给 AI Agent 设计的。
安装好 AI Skills 后,你可以对 Open Code / Aider 等 AI 工具说:
- 「帮我读一下这个飞书文档,总结一下要点」
- 「根据今天的 Git 提交,在飞书里创建一份日报文档」
- 「查一下明天下午 2 点大家有没有空,帮我创建一个会议」
- 「把这个多维表格的数据导出,分析一下趋势」
AI 会自动调用 lark-cli 完成操作——从「出主意」变成了「真的帮你做」。
实战案例:AI 自动发日报
# 让 AI 根据 Git 提交记录写日报,然后自动创建为飞书文档
git log --oneline -10 | ai "根据这些提交记录写一份简洁的日报" > /tmp/daily.md
lark-cli doc create --title "日报 $(date +%Y-%m-%d)" --body-file /tmp/daily.md
两条命令,日报就自动创建到飞书了。
安全提示
- 飞书 CLI 使用操作系统原生密钥链存储凭证,安全可靠
- 所有破坏性操作都支持
--dry-run预览,先看效果再执行 - 扫码授权时注意确认权限范围
飞书 CLI 是 AI 时代企业级 CLI 的标杆——不是给人用的命令行,而是给 AI 用的操控引擎。装上它,AI 终于能帮你真正「做事」了。