最近刷 GitHub,发现了字节跳动开源的一个项目 —— lark-cli。
1.7K+ star、Go 语言编写、200+ 命令、19 个 AI Agent Skills……
它把飞书(Lark/Feishu)所有的核心能力搬到了命令行,而且专为 AI Agent 设计。
01 它是什么?
lark-cli 是飞书开放平台(Lark/Feishu Open Platform)的命令行工具。
简单说:你在飞书 App 里干的那些事 —— 查日历、发消息、管文档、读写表格、处理任务、查邮件 —— 现在一条命令就能搞定。
而且它的定位不只是给人用,它从第一天就是为 AI Agent 设计的。
02 核心原理/亮点
1. 全链路覆盖 11 大业务域
| 业务域 | 能做的事 |
|---|---|
| 📅 Calendar | 查日程、创建会议、查忙闲、建议会议时间 |
| 💬 Messenger | 发消息、回复、创建群聊、搜索历史消息 |
| 📄 Docs | 创建、读写、搜索文档 |
| 📊 Sheets | 读写电子表格、导出数据 |
| ✅ Tasks | 创建任务、管理子任务、设置提醒 |
| 读邮件、发邮件、管理草稿 | |
| 📁 Drive | 上传/下载文件、管理权限 |
| 📚 Wiki | 管理知识库节点 |
| 👤 Contact | 按姓名/邮箱/手机查联系人 |
| 🎥 Meetings | 查会议纪要、录像、AI 摘要 |
| 🏢 Base | 多维表格的数据管理 |
2. 三层命令架构,人和 AI 都友好
- Shortcuts(
+前缀):傻瓜式命令,智能默认参数,人和 AI 直接用lark-cli calendar +agenda lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello" - API Commands:平台 API 1:1 映射,精确控制
lark-cli calendar calendars list - Raw API:2500+ 底层接口全覆盖
lark-cli api GET /open-apis/calendar/v4/calendars
3. AI Agent 原生设计
项目内置了 19 个 AI Agent Skills,可以让 Claude Code、OpenClaw 等 Agent 直接操控飞书,零配置上手。
# AI Agent 安装方式
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g
# 配置 & 登录(AI Agent 会自动引导用户授权)
lark-cli config init --new
lark-cli auth login --recommend
4. 安全防护
内置输入注入保护、输出内容清理、系统 Keychain 凭据存储,文档里有专门的安全风险提示 —— 用 AI 操控企业数据,这是认真在考虑的。
03 应用场景
谁适合用?
- 企业开发者:用脚本自动化飞书操作(定时推送日报、自动创建周会日程等)
- AI Agent 开发者:让 AI 助手直接操控飞书,实现「语音指令管团队」的工作流
- 效率极客:不想在 GUI 里点点点,直接终端搞定一切
- 运维/DevOps:将飞书通知集成到 CI/CD 流水线
实际使用示例
发一条消息:
lark-cli im +messages-send --chat-id "oc_xxx" --text "项目已上线,请验收"
查本周日历:
lark-cli calendar +agenda
AI Agent 直接帮你读邮件并回复:
lark-cli mail +search --keyword "合同" --limit 5
04 快速上手
安装(3 分钟跑起来)
# 方式一:npm 安装(推荐)
npm install -g @larksuite/cli
# 安装 CLI SKILL(必需)
npx skills add larksuite/cli -y -g
# 初始化配置(交互式引导)
lark-cli config init
# 登录授权
lark-cli auth login --recommend
# 验证是否成功
lark-cli auth status
查看所有命令
lark-cli --help
lark-cli calendar --help # 查看日历相关命令
lark-cli im --help # 查看消息相关命令
写在最后
飞书在国内的企业协作市场已经占了很大份额,但其开放平台的能力一直缺乏好用的终端入口。
lark-cli 用一个 CLI 把飞书的全部能力释放了出来,而且从设计第一天就考虑了 AI Agent 场景——这一点在当前 Agent 大爆发的时间节点上,格外有价值。
如果你在用飞书,又在探索 AI Agent 工作流,这个项目值得试试。
相关链接:
- GitHub:github.com/larksuite/c…
- 飞书开放平台:open.feishu.cn/
- 官方文档:github.com/larksuite/c…