乐于分享
好东西不私藏

飞书CLI:让AI直接操作你的飞书(一)场景与配置

飞书CLI:让AI直接操作你的飞书(一)场景与配置

你有没有想过——

对着AI说一句"帮我查一下明天的日程",它就能直接读取你的飞书日历?说一句"把这份方案发到项目群",消息就自动发出去了?

这不是科幻,这是飞书CLI正在做的事。

· · ·

什么是飞书CLI

2026年3月,飞书官方开源了命令行工具 larksuite/cli,把飞书2500+开放API封装成了200+条终端命令。

更关键的是——它原生为AI Agent设计,内置24个开箱即用的Skill,让Claude Code、Cursor、Trae等主流AI工具无需额外适配就能直接操作飞书。

简单说:装上它,你的AI助手就能帮你读消息、查日历、写文档、管表格、发邮件。

· · ·

能干什么:17大业务域一览

飞书CLI覆盖了飞书几乎全部核心功能:

领域
能力
📅 日历
查看/创建/更新日程、邀请参会人、查会议室、查询忙闲
💬 即时通讯
发送/回复消息、管理群聊、搜索消息、下载文件
📄 云文档
创建/读取/更新文档、搜索文档、读写画板
📝 Markdown
创建/读取/覆盖更新原生.md文件
📊 多维表格
管理数据表、字段、记录、视图、仪表盘、表单、权限
📈 电子表格
创建/读取/写入/追加/查找/导出表格数据
🖼️ 幻灯片
创建管理演示文稿、增删幻灯片
✅ 任务
创建/查询/更新/完成任务、子任务、提醒
📚 知识库
管理知识空间、节点和文档
📧 邮箱
浏览/搜索/发送/回复邮件、草稿管理、监听新邮件
🎥 视频会议
搜索会议记录、查询纪要和录制
✍️ 审批
查询/同意/拒绝/转交审批、撤回与抄送
🎯 OKR
查询/创建/更新OKR、管理目标和关键结果

还有通讯录、考勤、飞书项目等,一共17大业务域

· · ·

谁在用:三大典型场景

场景一:AI Agent直接操作飞书

这是飞书CLI最核心的设计目标。安装Skill后,AI编程助手可以直接调用飞书能力:

  • "帮我查一下今天下午有什么会议" → AI读取日历
  • "把这段内容写到飞书文档里" → AI创建/更新文档
  • "给项目组发个通知,方案已更新" → AI发送群消息
  • "把上次会议的待办整理成任务" → AI创建任务

你只需要说,AI帮你做。 不用打开飞书,不用复制粘贴,不用切窗口。

场景二:开发者的终端利器

不想切到飞书界面?在终端里就能搞定:

代码bash

# 查看今日日程 lark-cli calendar +agenda  
# 给群聊发消息 lark-cli im +messages-send --chat-id "oc_xxx" --text "方案已更新"  
# 创建飞书文档 lark-cli docs +create --api-version v2 --doc-format markdown \   --content $&#x27;<title>周报</title>\n# 本周进展\n- 完成了X功能&#x27;

对于习惯终端的开发者,这是效率的质变——不用离开命令行就能完成飞书操作。

场景三:CI/CD自动化集成

部署完成自动通知、定时备份飞书文档、监控数据写入飞书表格……飞书CLI天然适合集成到自动化流水线中:

代码bash

# 构建成功后通知 lark-cli im +messages-send --chat-id "oc_xxx" \   --text "✅ v2.1.0 构建成功,已部署到staging"

脚本化、可编排、可定时,把飞书从"聊天工具"变成"自动化枢纽"。

· · ·

三层命令架构:从简单到全面

飞书CLI的设计很聪明,提供了三种粒度的调用方式,按需选择:

第一层:快捷命令+ 前缀)

人机友好,内置智能默认值,适合日常快速操作:

代码bash

lark-cli calendar +agenda lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"

第二层:API命令

与飞书开放平台端点一一对应,100+精选命令,适合需要精细控制的场景:

代码bash

lark-cli calendar events instance_view \   --params &#x27;{"calendar_id":"primary","start_time":"1700000000","end_time":"1700086400"}&#x27;

第三层:通用调用

直接调用任意飞书API端点,覆盖2500+接口,适合高级用户:

代码bash

lark-cli api GET /open-apis/calendar/v4/calendars lark-cli api POST /open-apis/im/v1/messages \   --params &#x27;{"receive_id_type":"chat_id"}&#x27; \   --data &#x27;{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}&#x27;

新手用第一层,进阶用第二层,硬核用第三层,平滑过渡,没有学习断层。

· · ·

手把手配置指南

第1步:安装

方式一:npm安装(推荐)

代码bash

npx @larksuite/cli@latest install

一行命令,安装二进制文件 + 24个AI Agent Skill。

方式二:源码安装

需要Go 1.23+和Python 3:

代码bash

git clone https://github.com/larksuite/cli.git cd cli make install npx skills add larksuite/cli -y -g

第2步:创建飞书应用

  1. 1
    访问 [open.feishu.cn/app](https://open.feishu.cn/app),用飞书账号登录
  2. 2
    点击「创建自建应用」,填写应用名称和描述
  3. 3
    进入「凭证与基本信息」,找到 App ID 和 App Secret
  4. 4
    记下这两个值,下一步要用

💡 这一步相当于给CLI一个"身份",后续所有API调用都以此应用的名义进行。

第3步:配置凭证

代码bash

lark-cli config init

交互式引导,输入App ID和App Secret。凭证存储在 ~/.lark-cli/config.yaml,App Secret会加密存储。

如果你是AI Agent辅助配置,使用 lark-cli config init --new,它会输出授权链接供浏览器打开。

第4步:登录授权

代码bash

lark-cli auth login --recommend

--recommend 会自动选择常用权限范围,适合快速上手。

命令会输出一个授权链接,在浏览器中打开并同意授权即可。

如果只需要特定业务域的权限:

代码bash

lark-cli auth login --domain calendar,task

第5步:验证

代码bash

lark-cli auth status   # 查看登录状态 lark-cli doctor        # 全面健康检查

doctor 命令会检查配置、认证、网络连接和Skill文件完整性,有问题会给出具体修复建议。

第6步(可选):开启Shell补全

代码bash

lark-cli completion bash   # Bash lark-cli completion zsh    # Zsh lark-cli completion fish   # Fish

将输出加入Shell配置文件,之后Tab键自动补全命令和参数。

· · ·

安全须知

飞书CLI在安全方面做了不少工作:

  • 凭证加密存储
    :OAuth令牌存在操作系统原生密钥链(macOS钥匙串 / Windows凭据管理器 / Linux Secret Service)
  • 输入防注入
    :防止命令注入攻击
  • 终端输出净化
    :敏感信息不会意外泄露
  • dry-run预览
    :写操作前可先 --dry-run 预览

但需要注意:授权飞书权限后,AI Agent将以你的用户身份在授权范围内执行操作。 建议将对接的飞书机器人作为私人助手使用,不要拉入群聊或让他人与其交互。

· · ·

小结

飞书CLI的本质是把飞书从一个App变成一个可编程平台

  • 对于AI Agent,它是双手——让AI能直接操作你的飞书
  • 对于开发者,它是终端里的飞书——不用离开命令行
  • 对于运维,它是自动化枢纽——CI/CD、定时任务、脚本编排

三步安装,五步配置,从敲下第一条命令到AI帮你操作飞书,整个过程不超过十分钟。

下一篇,我们将深入飞书CLI的核心能力——24个AI Agent Skill详解,看看每个Skill能做什么,以及如何让你的AI助手真正"接管"飞书。

· · ·

飞书CLI项目地址:[github.com/larksuite/cli](https://github.com/larksuite/cli)

— 全文完 —

如果对你有帮助,欢迎点个 在看 👀 或 转发 给朋友 🙌