夜雨聆风你有没有想过——
对着AI说一句"帮我查一下明天的日程"，它就能直接读取你的飞书日历？说一句"把这份方案发到项目群"，消息就自动发出去了？
这不是科幻，这是飞书CLI正在做的事。
· · ·
什么是飞书CLI
2026年3月，飞书官方开源了命令行工具 larksuite/cli，把飞书2500+开放API封装成了200+条终端命令。
更关键的是——它原生为AI Agent设计，内置24个开箱即用的Skill，让Claude Code、Cursor、Trae等主流AI工具无需额外适配就能直接操作飞书。
简单说：装上它，你的AI助手就能帮你读消息、查日历、写文档、管表格、发邮件。
· · ·
能干什么：17大业务域一览
飞书CLI覆盖了飞书几乎全部核心功能：
还有通讯录、考勤、飞书项目等，一共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 $'<title>周报</title>\n# 本周进展\n- 完成了X功能'对于习惯终端的开发者，这是效率的质变——不用离开命令行就能完成飞书操作。
场景三：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 '{"calendar_id":"primary","start_time":"1700000000","end_time":"1700086400"}'第三层：通用调用
直接调用任意飞书API端点，覆盖2500+接口，适合高级用户：
代码bash
lark-cli api GET /open-apis/calendar/v4/calendars lark-cli api POST /open-apis/im/v1/messages \ --params '{"receive_id_type":"chat_id"}' \ --data '{"receive_id":"oc_xxx","msg_type":"text","content":"{\"text\":\"Hello\"}"}'新手用第一层，进阶用第二层，硬核用第三层，平滑过渡，没有学习断层。
· · ·
手把手配置指南
第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
访问 [open.feishu.cn/app](https://open.feishu.cn/app)，用飞书账号登录 - 2
点击「创建自建应用」，填写应用名称和描述 - 3
进入「凭证与基本信息」，找到 App ID 和 App Secret - 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)
— 全文完 —
如果对你有帮助，欢迎点个 在看 👀 或 转发 给朋友 🙌
