飞书CLI + Skill 完全指南：让AI真正替你操作飞书
引言：为什么需要飞书CLI？
在过去，我们和AI的对话类似于“纸上谈兵”：AI能给出完美的建议，却无法真正执行。当你想让AI帮你总结群聊记录、创建会议纪要和待办事项时，传统的做法是你手动复制粘贴，AI只负责动脑，你得负责动手。
现在飞书 CLI的诞生打破了这一僵局。作为飞书官方开源的命令行工具，它将飞书 2500+ 的开放 API 封装成了 AI 友好的命令行指令 。
装上飞书 CLI 后，AI可以直接读取你的飞书文档、发送消息、管理日程，甚至替你在多维表格里填数据。你只需要在对话框里像交代助理一样说句话，AI就会调用Skill工具集替你完成从“思考”到“执行”的全过程。
一、飞书Skill能力全景
飞书 CLI 之所以强大，核心在于它内置了19个开箱即用的 Skills。这些 Skill 覆盖了飞书的 11 大核心业务域，是 AI 操作飞书的“手势库”。
以下是核心 Skill 模块及其功能说明：
模块 （Skill） | 核心能力说明 （What AI can do） | 典型应用场景 |
lark-shared | 基础底座 ：包含应用配置、认证登录、身份切换、权限管理、安全规则。所有其他 Skill 的基石 | 安装后的初始化配置、多账号切换、企业权限校验 |
lark-doc | 文档大师 ：基于 Markdown 创建、读取、更新、搜索飞书云文档 | 自动生成周报、清洗需求文档、撰写技术方案 |
lark-sheets | 表格处理 ：创建、读取、写入、追加、查找、导出电子表格数据 | 爬取网页数据自动入库、批量数据清洗、导出报表 |
lark-base | 多维表格 ：操作字段、记录、视图、仪表盘，支持数据聚合分析 | 低代码应用数据录入、自动化看板更新、CRM 数据同步 |
lark-im | 即时通讯 ：发送/回复消息、群聊管理、消息搜索、上传下载文件 | 自动发送告警通知、根据关键词总结群聊未读消息 |
lark-calendar | 日程管理 ：日历日程增删改查、忙闲查询、时间建议 | 自动安排会议时间、生成日程待办清单 |
lark-task | 任务中心 ：任务清单、子任务、提醒、成员分配管理 | 根据会议纪要自动创建待办任务并分配给具体人 |
lark-wiki | 知识库 ：操作知识空间、节点（页面）、文档 | 自动归档过期文档、批量迁移 Wiki 页面结构 |
lark-drive | 云盘管理 ：上传/下载文件、管理权限、添加文档评论 | 批量下载云空间附件、在文档具体段落添加审阅评论 |
lark-mail | 邮件处理 ：搜索、阅读、发送、回复、转发邮件，草稿管理 | 自动读取验证码邮件、定时发送批量日报邮件 |
lark-contact | 组织通讯录 ：按姓名/邮箱/手机号搜索用户，获取用户信息 | 查找“研发部张三”的 Open ID 用于流程审批 |
lark-vc | 视频会议 ：查询会议记录、获取会议纪要产物（总结、待办、逐字稿） | 飞书妙记自动总结、提取会议关键决策 |
lark-minutes | 妙记分析 ：获取妙记元数据与 AI 产物（章节总结、智能待办） | 根据妙记逐字稿生成培训笔记 |
lark-event | 实时订阅 ：通过 WebSocket 订阅事件，支持正则路由 | 监听“当有新文档创建时”自动触发分类归档流程 |
lark-whiteboard | 画板渲染 ：支持画板/图表的 DSL 渲染 | 将文本流程图（Mermaid）自动转为飞书画板 |
lark-openapi-explorer | API 探索 ：探索飞书底层 API 接口详情 | 深度开发时查阅字段限制、调试复杂接口 |
lark-skill-maker | 自定义 Skill ：自定义 Skill 创建框架 | 业务人员封装专属于自己的“一键发版”Skill |
lark-workflow-meeting-summary | 工作流-会议 ：会议纪要汇总与结构化报告 | 自动汇总本周所有参会记录的待办事项 |
lark-workflow-standup-report | 工作流-日报 ：日程待办摘要，生成站立会议报告 | 根据日历和任务自动生成“昨天做了啥”日报 |
二、环境搭建与配置
要让 AI 获得上述“超能力”，需要先完成飞书 CLI 的安装和授权。以下是标准操作步骤：
1. 安装 CLI 工具
在终端（Terminal）中输入以下命令进行全局安装：
npm install -g @larksuite/cli2. 安装 Skill 套件
这是最关键的一步，将 Skill 能力注入到你的 AI 环境（如 Codex、Cursor、Claude Code）中：
npx skills add larksuite/cli -y -g注意：如果不执行这一步，AI 无法理解“帮我读一下飞书文档”这类自然语言指令 。
3. 配置应用凭证
为了让 CLI 知道该操作哪个飞书企业，需要创建或选择一个飞书应用。
执行以下命令并按照提示操作：
lark-cli config init --new如果是新用户：命令执行后会弹出一个浏览器链接。打开后，点击“创建企业自建应用”，系统会自动生成 App ID 和 Secret。
已有应用：在浏览器弹出的页面中，直接选择你已有的应用进行绑定即可。
复制链接在浏览器中打开
打开后默认是这样子，如果没有飞书应用的话，则直接点击创建即可
创建之后，就会有appid和secret
4. 登录与授权（用户身份）
这一步让 AI 拥有你的个人身份权限（如读取你的私聊、个人日程）。
lark-cli auth login --recommend浏览器中打开，并且授权
开通并授权后：浏览器页面中的显示
5. 状态验证
运行以下命令确认一切就绪：
lark-cli auth status如果显示你的用户信息和应用信息，恭喜你，安装成功！
三、实战演练：让 AI 读取文档并分析
配置完成后，可以直接在 Codex 或 Cursor 的对话框中输入自然语言指令，AI 会自动调用对应的 Skill 完成复杂工作。
场景一：发送消息
你的指令（Prompt）：
“用飞书 Skill 给我账号发一句你好”
AI 的底层动作：
AI 会自动识别你的身份，调用lark-im模块下的消息发送接口，将“你好”推送到你的飞书“企业应用助手”会话中。
验证：打开飞书，你会收到来自 “CLI” 或自定义应用名称的消息 。
场景二：读取需求文档设计测试用例（最实用场景）
假设产品经理在飞书文档里写了一篇 PRD（产品需求文档），作为测试或开发人员，你不需要手动复制出来。
你的指令（Prompt）：
“读取这个飞书文档 [文档链接]，帮我转化成md结尾的需求文档”
AI 的底层动作：
调用
lark-doc+ fetch：AI 提取 URL 中的文档 ID，通过 CLI 读取文档的 Markdown 格式内容。逻辑分析：AI 理解文本逻辑（如用户登录流程、边界条件）。
结构化输出：AI 生成结构清晰的测试点列表或脑图。
这样，你可以让 AI 直接基于“最新版”的线上文档工作，彻底告别文档下载、复制粘贴和版本错乱。
接着就可以继续利用这个分析需求和生成用例的skill继续执行操作：
OpenTest Skill 操作指南
概述 OpenTest 本质上是一套为测试场景定制的 Skills合集，将需求分析 → 测试点梳理 → 用例生成 → 云效导入串联为标准化流水线。通过 4 个 Skill 指令，即可完成从 PRD 到可导入云效 Testhub 的测试用例文
四、踩坑与避坑指南
重启 AI 客户端：在完成 CLI 和 Skill 安装后，如果 AI 无法调用飞书接口，需要重启你的 Codex、Cursor 或 Claude Code 编辑器，以确保新的 Skill 被加载 。
权限不足：如果 AI 操作失败提示
No permission，通常是因为你的应用没有开通对应权限（如读取邮件权限）。CLI 会在报错中提示缺失的 Scope，你可以根据提示在 [飞书开放平台]（https：//open.feishu.cn/app） 找到你的应用，在“权限管理”中添加对应的权限，并等待 5-10 分钟生效 。搜索不到文档：
docs +search命令通常需要用户身份（User Access Token）才能搜索到个人云空间的内容。如果搜索不到，请确认已执行lark-cli auth login并授权了“获取云空间文件”权限 。
五、总结
飞书 CLI 不仅仅是一个命令行工具，它是连接 AI 大模型与企业办公数据的桥梁。通过19 个内置 Skill，AI 从“聊天机器人”进化为真正的“数字员工”。
建议工作流如下：
开会时：AI 监听会议（lark-vc） -> 生成妙记（lark-minutes） -> 自动写文档（lark-doc）。
上班时：AI 读取日程（lark-calendar） -> 汇总群消息（lark-im） -> 创建多维表格任务（lark-base）。
按照上述教程完成安装后，你就可以开始尝试用自然语言指挥 AI 去操作飞书了。
参考链接：
飞书 CLI 官方 GitHub：http://https：//github.com/larksuite/cli
官方安装文档：http://https：//open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md