今天,飞书官方开源了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,写几句自然语言指令就能跑起来。
你的办公方式,马上就会被完全颠覆。
夜雨聆风