【GitHub 热点】1.7K+ star 字节出品!这个 CLI 工具让飞书「操控自由」到达新高度

0 阅读3分钟

最近刷 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 设计的

Star History


02 核心原理/亮点

1. 全链路覆盖 11 大业务域

业务域能做的事
📅 Calendar查日程、创建会议、查忙闲、建议会议时间
💬 Messenger发消息、回复、创建群聊、搜索历史消息
📄 Docs创建、读写、搜索文档
📊 Sheets读写电子表格、导出数据
✅ Tasks创建任务、管理子任务、设置提醒
📧 Mail读邮件、发邮件、管理草稿
📁 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 工作流,这个项目值得试试。


相关链接: