绝大多数开发者、职场人对 AI 办公的认知还停留在：AI 生成内容→手动复制→手动上传飞书。效率极低、无法闭环、无法自动化。
飞书官方开源的Feishu CLI（Lark CLI）+ AI Skill，是 2026 年目前最强、最稳定、零开发、可生产落地的 AI 飞书打通方案。
它彻底解决核心痛点：让 Claude Code、Codex、Cursor 等所有 AI Agent，拥有你的飞书账号权限，全自动操作飞书全功能。
不需要写接口、不需要开发机器人、不需要配置 Webhook、不需要对接 OpenAPI。纯命令行 + Skill 规则，即可实现：
- AI 自动发飞书消息、群通知、私聊推送
- AI 自动创建 / 编辑 / 汇总飞书文档、表格
- AI 自动读写多维表格、同步项目进度
- AI 自动创建日程、参会提醒、日历管理
- AI 自动收发邮件、管理任务、归档资料
本文为全网最完整生产级指南：底层原理、环境依赖、一键安装、授权流程、Skill 技能加载、AI Agent 联动、实战命令、报错排查、落地工作流全覆盖，小白可直接复刻，工程师可直接用于企业自动化落地。
一、核心认知：什么是飞书 CLI？什么是飞书 Skill？
很多人混淆两个概念，导致配置失败、AI 无法调用飞书能力，先彻底厘清底层逻辑。
1.1 飞书 CLI（Lark CLI）
飞书官方推出的命令行交互工具，本质是：飞书所有 OpenAPI 的命令行封装。 无需手写 HTTP 请求、无需拼接 Token、无需处理签名，终端一条命令即可调用飞书全量能力。 核心优势：原生信任 AI Agent、无跨域、无接口调试成本、支持用户身份授权。
1.2 飞书 AI Skill（核心灵魂）
Skill 是专门给 AI Agent 阅读的能力规则说明书，官方内置 19 大类标准化技能包，覆盖飞书全部高频场景： IM 消息、文档 Doc、多维表格 Base、日历 Calendar、邮件 Mail、任务 Task、项目 Project、云盘 File、权限管理、团队信息、内容检索、数据导出。
简单理解：CLI = 可执行工具Skill = AI 的使用说明书没有 Skill，AI 不会调用 CLI；没有 CLI，Skill 无执行载体。二者结合，才是完整的「AI 操控飞书」体系。
1.3 和传统飞书机器人的本质区别
传统机器人：机器人身份，权限受限、无法操作个人文档、私人日历、私聊； 飞书 CLI+Skill：你的个人身份授权，和你本人操作完全一致，权限全覆盖。
二、前置环境要求（必看，避免 90% 报错）
仅需基础前端环境，全平台通用（Windows/Mac/Linux）
- Node.js ≥ 18.0（推荐 22+，兼容性最佳）
- npm /yarn 正常可用
- 本地终端网络正常
- 可用个人飞书账号（企业 / 个人版均可）
三、生产级完整安装流程（分步可复刻）
步骤 1：全局安装飞书 CLI 本体
终端执行全局安装命令，部署飞书命令行能力：
npm install -g @larksuite/cli安装完成后，终端全局可用lark-cli命令。
步骤 2：安装官方 AI Skill 技能包（关键步骤）
Skill 是 AI 识别能力的核心，全局安装后所有本地 Agent 自动加载：
npx skills add larksuite/cli -y -g执行后自动拉取全套 Skill 规则，写入 Agent 全局目录。
步骤 3：飞书账号授权（AI 获得你的操作权限）
lark-cli auth login --recommend运行后生成授权链接，浏览器打开完成：
- 登录个人飞书账号
- 确认授权创建飞书 CLI 官方应用
- 勾选常用权限，确认授权 授权成功，飞书客户端会收到通知。
步骤 4：环境校验
lark-cli auth status输出「已登录、授权有效、权限正常」代表整套环境就绪。
四、AI Agent 联动配置（Claude Code / Codex / Cursor 通用）
飞书 Skill 兼容主流 VibeCoding 智能体，配置逻辑统一，无需修改配置文件。 通用激活规则：
- 安装 CLI 与 Skill 之后，重启 IDE/Agent 终端
- Agent 自动扫描全局 Skill 规则，无需手动导入
- 直接使用自然语言下达指令，AI 自动调用 lark-cli 执行
首次启用万能提示词（直接复制发送一次即可）
你已经成功加载飞书 CLI 全套 Skill 能力。后续所有飞书相关操作，请直接调用本地 lark-cli 命令完成，不需要让我手动在终端输入指令。
五、九大高频实战场景，可直接复制指令
场景 1：AI 自动发送飞书群消息 / 私聊通知
调用飞书 CLI，向我的工作群发送通知：今日项目代码迭代完成，全部功能自测完毕，请团队成员查阅进度。
场景 2：AI 自动创建、撰写飞书文档
通过飞书 CLI 新建飞书文档，标题【本周项目开发周报】，整理本周开发进度、已完成功能、遗留待办，排版分段清晰。
场景 3：AI 自动读写飞书多维表格
读取指定多维表格数据，统计本周完成任务与逾期任务，自动更新表格进度字段，输出一份简短汇总。
场景 4：AI 自动创建管理日历日程
在本周四 15:00 新建项目评审会议，时长一小时，添加工作群参会人，开启会前 15 分钟提醒。
场景 5：AI 自动整理飞书云盘文件
扫描飞书云盘本周新增文件，按照文档、截图、压缩包分类整理，输出完整文件清单。
场景 6：AI 读取、撰写飞书邮件
读取最新收到的飞书邮件，提炼核心信息，并生成简洁得体的回复文本。
场景 7：全自动生成日报周报并推送团队（完整闭环）
汇总今日工作内容，生成标准化开发日报，保存为飞书文档，并将文档链接发送至工作沟通群。
六、官方 Skill 能力清单
安装完成后，Agent 原生具备下述模块能力：
- lark-im：消息发送、群管理、消息读取、通知推送
- lark-doc：文档新建、编辑、排版、归档、权限调整
- lark-base：多维表格增删改查、数据统计、字段更新
- lark-calendar：日程新建、修改、删除、参会人与提醒管理
- lark-mail：邮件收发、内容整理、自动生成回复
- lark-task：任务创建、进度更新、待办事项汇总
- lark-file：云盘文件上传、下载、分类归档
- lark-search：全局检索消息、文档、云盘资料
- lark-team：查询团队成员、部门组织信息
七、高频报错排查
报错 1：command not found: lark-cli
原因：全局包未写入环境变量 解决方案：重新执行安装命令，或者完全重启终端。
报错 2：AI 不会调用飞书相关能力
原因：Skill 未加载、Agent 没有重启 解决方案：重新执行npx skills add larksuite/cli -y -g，重启 Cursor / Claude Code。
报错 3：操作提示权限不足
原因：授权阶段权限勾选不全、登录会话过期 解决方案：重新执行lark-cli auth login --recommend完成重新授权。
报错 4：命令返回成功，飞书无内容变更
原因：账号缓存、登录身份不匹配 解决方案：执行lark-cli auth status确认当前登录账号，重试指令。
八、终极自动化落地工作流（个人 / 团队通用）
- AI Agent 汇总当日开发与工作信息
- 自动生成日报、周报、技术复盘文档
- 自动同步项目进度至多维表格
- 将文档链接推送至工作群
- 同步更新个人日历待办与会议安排
整套流程全程人工零干预，形成完整 AI 办公闭环。
九、全文总结
- 零开发成本：不用对接 OpenAPI、不用独立服务，开箱即用；
- 真人同等权限，突破传统机器人功能限制，支持私人文档、私聊、个人日历；
- AI 原生适配 Skill 体系，自然语言即可驱动复杂办公操作；
- 全链路自动化，摆脱反复复制粘贴、手动汇总资料；
- 官方开源方案，安全稳定，无第三方中间代理。
下一代 AI 办公不再只是单纯生成文字，而是由 AI 执行完整业务流程。飞书 CLI + Skill，打通了本地 AI Agent 与企业办公工具最重要的一环，非常适合 VibeCoding 开发者、独立从业者、技术团队落地自动化流程。
