Lark CLI (飞书CLI)

这是什么？适合谁？

Lark CLI 是飞书官方出品的命令行工具，既面向人类用户也面向 AI Agent。它覆盖了飞书核心业务域 API：消息、文档、日历、通讯录、审批等，让你在终端中就能完成飞书操作，天然适合 AI Agent 调用。

适合人群：飞书企业用户、需要自动化飞书操作的开发者、构建 AI Agent 工作流的工程师。

前置条件：飞书企业账号，已创建飞书应用并获取 App ID 和 App Secret。

准备工作

1. 安装：go install github.com/larksuite/cli@latest 或从 Release 下载二进制
2. 创建飞书应用：在飞书开放平台创建应用，获取凭证
3. 配置认证：lark-cli config set --app-id <ID> --app-secret <SECRET>
4. 时间预算：安装 2 分钟，首次配置 10 分钟

核心步骤

第一步：认证配置

lark-cli config init
lark-cli config set --app-id cli_xxx --app-secret xxx

第二步：发送消息

lark-cli message send --receive-id-type open_id --receive-id <ID> --content '{"text":"Hello from CLI"}'

第三步：AI Agent 调用

在 AI 工具中配置 MCP 或直接调用 CLI：

# 获取文档列表
lark-cli doc list --page-size 10

# 创建日历事件
lark-cli calendar create-event --summary "团队周会" --start-time "2026-08-06T10:00:00" --end-time "2026-08-06T11:00:00"

常见踩坑

1. 权限不足：飞书应用需要申请对应权限（如 im:message:send），在飞书开放平台审批
2. Token 过期：默认 token 有效期 2 小时，CLI 自动刷新但长时间不用需重新认证
3. API 频率限制：飞书 API 有频率限制（通常 100 次/秒），批量操作需控制速度
4. 消息格式：飞书消息使用 JSON 格式，结构复杂时容易出错，建议用 --template 参数
5. 国际版 vs 国内版：Lark（国际版）和飞书（国内版）API 域名不同，需正确配置

FAQ

Q1：和飞书开放平台 API 有什么区别？ A：CLI 是对 API 的封装，提供更友好的命令行接口，无需手动处理 Token 和请求签名。

Q2：AI Agent 能做什么？ A：发送消息、读取文档、管理日历、审批流程、查询通讯录等，几乎覆盖飞书全部功能。

Q3：免费吗？ A：CLI 工具开源免费（MIT），飞书 API 本身有免费额度。

Q4：支持批量操作吗？ A：支持，可通过脚本循环调用或使用 --batch 参数。

Q5：和飞书机器人有什么区别？ A：飞书机器人是被动接收消息，CLI 是主动调用 API，两者互补。

进阶学习

• 飞书 + AI Agent 自动化日报：定时拉取飞书文档内容，让 AI 总结后发送到群聊
• 飞书审批 + AI 决策：AI Agent 自动读取审批内容，根据规则自动批准或转发
• CLI + cron 定时任务：在服务器上配置定时任务，自动执行飞书操作
• 多应用管理：通过 lark-cli config use <profile> 切换多个飞书应用

参考链接

• 官方仓库
• 飞书开放平台
• 飞书 API 文档

本文基于公开资料整理，AI 辅助生成，数据核验日期 2026-08-06。独立实测和深度评测请参考评分文件。