夜雨聆风
每天打开飞书，你大概率会做这几件事：看日程、回消息、写文档、查多维表格、发个周报通知。
这些事情每件都不难，但加在一起就是一笔可观的时间税——在网页端和桌面端之间反复横跳，点击、等待、切换、再点击。你心里清楚这些都是重复劳动，但也没什么好办法。
现在有了。
2026 年 3 月 28 日，飞书开源了官方命令行工具 lark-cli，上线当天 GitHub Star 数破千，增长迅速。它不只是给开发者用的——它的设计目标写在 README 第一行：为人类和 AI Agent 双重设计。
这意味着，你可以在终端里一行命令完成上面那些日常操作；更重要的是，你可以让 AI Agent 替你做这些事。
这篇文章是一份可落地的实战指南：从安装配置讲到日常用法，再到如何与 Claude Code 联动实现自动化。如果你用飞书，这个工具值得花 10 分钟了解一下。
lark-cli 是什么：一个三层架构的飞书入口
lark-cli 最值得说的设计，是它的三层命令架构。这三层解决了不同场景的需求，也是它能同时服务人类和 AI 的关键。
第一层：Shortcuts（+ 前缀）——给人类和 AI 日常用的
lark-cli calendar +agendalark-cli im +messages-send --chat-id "oc_xxx" --text "周报已更新，请查阅"lark-cli docs +create --title "周报" --markdown "# 本周进展\n- 完成功能 A"Shortcuts 是最常用的一层。命令名直观，参数有智能默认值，一行搞定一件事。AI Agent 调用飞书时，90% 的情况用这一层就够了。
第二层：API Commands——给开发者精确操作用的
lark-cli calendar calendars listlark-cli calendar events instance_view --params '{"calendar_id":"primary","start_time":"1700000000","end_time":"1700086400"}'100 多个精选命令，和飞书开放平台的 API 端点一一对应。当 Shortcuts 覆盖不到你的需求时，降级到这一层。
第三层：Raw API——2500+ 接口全覆盖
lark-cli api GET /open-apis/calendar/v4/calendars直接调用飞书开放平台的任意 API。这是兜底方案，覆盖所有能力，但需要你自己拼参数。
这个三层设计的好处是：日常操作用 Shortcuts 极简完成，碰到边界情况可以逐层降级，不会卡在"这个功能 CLI 不支持"的死胡同里。
lark-cli 目前覆盖 11 大业务域：日历、即时通讯、云文档、云空间、多维表格、电子表格、任务、知识库、通讯录、邮箱、会议（含妙记）。此外还有画板、实时事件监听等扩展 Skill。
安装与配置：三步跑通
环境准备与安装
确保本地有 Node.js 环境，然后执行：
npm install -g @larksuite/clinpx skills add larksuite/cli -y -g第一行装 CLI 本体，第二行装配套的 19 个 Skills（覆盖 11 大业务域 + 画板、事件监听等扩展能力，后面讲 Claude Code 联动时会用到）。
配置应用凭证
lark-cli config init这是一个交互式引导，会自动在飞书开发者后台为你创建应用。跟着提示走就行。
如果你是给 AI Agent 配置（后台运行场景），用 lark-cli config init --new，它会输出一个授权 URL，在浏览器里打开完成授权即可，不需要终端保持前台交互。
注意：部分企业飞书环境可能需要管理员审批后才能使用，这不是 lark-cli 的问题，是企业的安全策略。
登录授权
lark-cli auth login --recommend--recommend 会一次性开通常用权限（日历、文档、消息、多维表格、邮箱等），省去逐个申请的麻烦。
这里有一个必须搞清楚的概念：user 身份 vs bot 身份。
• user 身份：代表你个人，访问你的日历、你的云空间、你的邮箱 • bot 身份：代表应用本身，用 appId + appSecret 自动认证，做应用级操作
选错身份是权限报错最常见的原因。比如你想查自己的日程，必须用 user 身份；用 bot 身份去访问个人日历，一定会报 Permission Denied。
另一个容易忽略的点：scope 是累积授权的。多次执行 lark-cli auth login，新授权的权限会叠加到已有权限上，不会覆盖之前的。
验证配置是否正常：
lark-cli doctor # 综合诊断，检查凭证、权限、连通性Permission Denied 怎么办
遇到权限错误时，lark-cli 的提示信息做得不错——它会告诉你缺少哪个 scope，并给出修复命令。按提示执行就好。
权限相关的详细命令可以通过 lark-cli auth --help 查看。
日常用法：5 个高频场景
以下命令基于 v1.0.0 官方文档整理，具体参数以 --help 和 Skill 文档为准。
查看今日日程
lark-cli calendar +agenda默认输出当天日程。如果想换格式：--format table（表格）、--format json（程序处理用）、--format pretty（美化输出）。
发送群消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "周报已更新，请查阅"chat-id 可以用 lark-cli im +chat-search 搜索你加入的群组来获取，也可以在飞书群设置中查看。不确定效果的话，先加 --dry-run 预览，确认无误再真正发送。
创建飞书文档
lark-cli docs +create --title "项目周报" --markdown "# 本周进展\n- 完成功能 A\n- 修复 Bug B"直接传 Markdown，lark-cli 自动转换成飞书文档格式。
多维表格查询
lark-cli base +data-query --app-token <你的多维表格 app_token> --table "销售数据"--app-token 是多维表格的唯一标识，可以从多维表格的 URL 中获取（URL 中 /base/ 后面那串字符）。不带 --query 参数默认列出全部记录。多维表格支持聚合查询（如按字段分组求和），但语法和标准 SQL 不同，具体写法参照官方文档（「阅读原文」中有链接）。建议先跑一次不带查询的命令，确认表结构后再写条件。
邮件收发
lark-cli mail +send --to "colleague@company.com" --subject "会议纪要" --body "附件已上传到云空间"注意：+send 默认行为是保存为草稿，需要确认后才会真正发送。这是一个安全设计，防止 AI Agent 误发邮件。邮箱相关的其他操作（查看、回复、转发等）通过 lark-cli mail 子命令完成，具体命令名以 lark-cli mail --help 输出为准。
与 Claude Code 联动：让 AI 替你操作飞书
这是 lark-cli 最有想象力的部分。
Skills 安装后即用
前面安装时执行的 npx skills add larksuite/cli -y -g，实际上给 Claude Code 装了 19 个 Skill。每个 Skill 对应一个飞书业务域，包含前置条件检查、身份选择逻辑和权限修复引导。
装完之后，你在 Claude Code 里直接用自然语言说需求就行：
"帮我查一下今天的日程，如果下午有空，创建一个 3 点的评审会议"
Claude Code 会自动调用对应的 lark-cli 命令完成操作。
实战：AI 自动生成项目周报
1. Claude Code 读取本周 git log，提取变更摘要 2. 生成 Markdown 格式的周报内容 3. 调用 lark-cli docs +create在飞书创建文档4. 调用 lark-cli im +messages-send在群里发通知
四步串起来，从代码提交记录到飞书文档再到群通知，全程自动。如果想定时执行，用 cron 或 launchd 调度即可。
实战：智能会议管理
场景："帮我找一个下周所有人都有空的 1 小时时段，创建评审会议"
Claude Code 的执行路径：查所有参会人的忙闲状态 → 计算共同空闲时段 → 推荐最优时间 → 创建日历事件 → 发送会议通知。手动操作需要在日历里逐个比对，来回十几分钟；交给 Agent，一句话搞定。
安全注意事项
把飞书操作交给 AI，安全是绕不开的话题。几个建议：
• 建议谨慎使用机器人的群聊权限，将其定位为私人助手更安全 • lark-cli 在执行写入和删除操作前会要求确认，这是内置的安全机制 • 善用 --dry-run，这是你的安全网——先看效果，再决定是否执行• 对于企业敏感数据，建议仅让 AI 处理非敏感操作（查日程、发通知），涉及机密内容的操作还是手动来
社区对这个问题也有讨论，主流观点是：用来做日常自动化没问题，但核心业务数据的操作要谨慎。
当前限制与生态
v1.0.0 已知限制（截至 2026-03-29）
lark-cli 刚发布，有些能力还没到位：
• 飞书审批尚未支持（GitHub Issue #42） • 飞书项目仅支持任务管理，项目级操作还不行（#38） • 知识库（wiki） 能力待补强（#58） • 云盘暂无法列出文件夹内的文件（#51） • Windows 下 --params的 JSON 解析可能失败（#64）• 配置门槛：有用户反馈初次配置流程不够顺畅（#54）
这些都是 v1.0.0 的已知短板，后续版本大概率会补上。
Skills vs MCP：怎么选
lark-cli 走的是 CLI + Skills 路线：轻量，不需要启动额外的服务进程，Agent 读取 SKILL.md 文件就能调用。
飞书官方同时提供了 lark-openapi-mcp（标准 MCP Server 方案），需要启动一个常驻进程。两者互补，Skills 更轻量通用，MCP 适合需要标准化集成的场景。
社区生态方面，已经有 Claude-to-IM Skills（让 Claude Code 连接飞书、QQ、Telegram 等 IM）、OpenCLI 集成、Feishu-MCP（同时支持 MCP 和 CLI+Skill 双模式）等项目。
写在最后
回到开头的场景：每天在飞书网页端反复切换窗口做重复操作。现在的选项是——终端一行命令搞定，或者让 AI Agent 代劳。
飞书之外，钉钉和企微也在朝类似方向走——企业协作工具正在批量开放 CLI 和 Agent 接口。lark-cli 的做法是从设计之初就把"AI 能直接调用"作为一等公民，而不是事后补一个 API 包装层。
审批、项目管理等业务域还在路上，值得持续关注。
如果你现在就想试试，装完后跑一下 lark-cli calendar +agenda，30 秒看到效果。
本文基于 lark-cli v1.0.0（2026-03-28 发布）撰写，命令和功能以实际版本为准。GitHub 仓库地址、官方文档及所有参考链接，请点击「阅读原文」查看。
