乐于分享
好东西不私藏

今天,飞书官方开源了CLI工具,让AI Agent直接操控飞书

今天,飞书官方开源了CLI工具,让AI Agent直接操控飞书

就在今天(2026年3月28日),飞书官方在 GitHub 上发布了 lark-cli 的 v1.0.0 版本。

这是一个命令行工具,目标只有一个:让人类和 AI Agent 都能在终端里操控飞书

项目地址:https://github.com/larksuite/cli

发布不到一天,已经收获 700多个Star,目前还在快速增长中。

万物皆可CLI,这件事的重要性再怎么强调都不为过。


它能做什么

lark-cli 覆盖了飞书几乎所有核心业务场景,提供 200+ 命令:

业务域
能力
日历
查看日程、创建日程、邀请参会人、查询忙闲
即时通讯
发送消息、管理群聊、搜索消息、下载媒体
云文档
创建、读取、更新、搜索文档
多维表格
管理表格、字段、记录、视图
电子表格
读写、追加、查找、导出数据
任务
创建任务、子任务、提醒、成员分配
邮箱
收发邮件、管理草稿、监听新邮件
视频会议
搜索会议记录、获取纪要与录制
知识库
管理知识空间、节点和文档

三层命令设计

工具提供三种粒度的调用方式,从简单到底层:

快捷命令(+ 前缀)

封装好参数和默认值,人和 AI 都好用:

lark-cli calendar +agendalark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"lark-cli docs +create --title "周报" --markdown "# 本周进展\n- 完成了 X 功能"

API 命令

从飞书开放平台 API 元数据自动生成,精选了 100+ 个:

lark-cli calendar calendars listlark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1700000000","end_time":"1700086400"}'

通用 API 调用

直接访问 2500+ 个飞书开放平台接口:

lark-cli api GET /open-apis/calendar/v4/calendarslark-cli api POST /open-apis/im/v1/messages --params '{"receive_id_type":"chat_id"}' --body '{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}'

真正的亮点:19 个 Agent Skills

lark-cli 不只是个命令行工具,更是专门为 AI Agent 设计的飞书接入层

它提供 19 个开箱即用的 Agent Skills,直接兼容 Claude Code、Cursor 等主流 AI 工具。装好之后,AI Agent 不需要任何额外适配,就能直接读邮件、发消息、创建日历、写文档。

安装方式:

npm install -g @larksuite/clinpx skills add larksuite/cli -y -g

Skills 列表覆盖所有业务域:

  • lark-im — 消息、群聊
  • lark-doc — 云文档(基于 Markdown)
  • lark-base — 多维表格
  • lark-calendar — 日历与日程
  • lark-mail — 邮件收发
  • lark-task — 任务管理
  • lark-event — 实时事件订阅(WebSocket)
  • lark-workflow-meeting-summary — 会议纪要自动汇总
  • lark-workflow-standup-report — 日程待办摘要
  • 还有更多……

其中 lark-event 比较有意思,支持 WebSocket 实时事件订阅,配合正则路由,Agent 可以监听飞书里发生的事情并自动响应。

认证设计

登录用 OAuth,交互简单:

# 推荐的 scope 一键授权lark-cli auth login --recommend# 按业务域筛选lark-cli auth login --domain calendar,task# Agent 模式:立即返回验证 URL,不阻塞lark-cli auth login --domain calendar --no-wait

支持多用户身份切换,可以分别以 user 和 bot 身份发送消息:

lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"

安全注意事项

工具在文档里给出了很直接的风险提示:AI Agent 以你的用户身份执行操作,存在模型幻觉、执行不可控、提示词注入等风险。

官方建议:把接入这个工具的飞书机器人作为私人助手使用,不要拉进群聊

工具本身已启用默认的输入防注入和终端输出净化,凭证存储在 OS 原生密钥链里,不建议修改默认安全配置。

用飞书的团队值得关注

如果你的团队用飞书,这个工具开辟了一条新的自动化路径。

过去想做飞书自动化,要么自己调 API,要么用飞书机器人开发框架,门槛不低。现在有了 lark-cli,AI Agent 可以直接接管日历安排、消息通知、文档协作这些日常工作,而不需要写一行集成代码。

一个典型场景:让 Claude Code 在每天早上读取你的飞书日历,生成今日待办摘要,发送到指定群聊。装好 Skills,写几句自然语言指令就能跑起来。

你的办公方式,马上就会被完全颠覆。