引言为什么需要飞书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-explorerAPI 探索探索飞书底层 API 接口详情深度开发时查阅字段限制、调试复杂接口lark-skill-maker自定义 Skill自定义 Skill 创建框架业务人员封装专属于自己的“一键发版”Skilllark-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和secret4. 登录与授权用户身份这一步让 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 fetchAI 提取 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 个内置 SkillAI 从“聊天机器人”进化为真正的“数字员工”。建议工作流如下开会时AI 监听会议lark-vc - 生成妙记lark-minutes - 自动写文档lark-doc。上班时AI 读取日程lark-calendar - 汇总群消息lark-im - 创建多维表格任务lark-base。按照上述教程完成安装后你就可以开始尝试用自然语言指挥 AI 去操作飞书了。参考链接飞书 CLI 官方 GitHubhttp://https//github.com/larksuite/cli官方安装文档http://https//open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md
飞书CLI + Skill 完全指南：让AI真正替你操作飞书
发布时间：2026/6/4 15:36:51
引言为什么需要飞书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-explorerAPI 探索探索飞书底层 API 接口详情深度开发时查阅字段限制、调试复杂接口lark-skill-maker自定义 Skill自定义 Skill 创建框架业务人员封装专属于自己的“一键发版”Skilllark-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和secret4. 登录与授权用户身份这一步让 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 fetchAI 提取 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 个内置 SkillAI 从“聊天机器人”进化为真正的“数字员工”。建议工作流如下开会时AI 监听会议lark-vc - 生成妙记lark-minutes - 自动写文档lark-doc。上班时AI 读取日程lark-calendar - 汇总群消息lark-im - 创建多维表格任务lark-base。按照上述教程完成安装后你就可以开始尝试用自然语言指挥 AI 去操作飞书了。参考链接飞书 CLI 官方 GitHubhttp://https//github.com/larksuite/cli官方安装文档http://https//open.feishu.cn/document/no_class/mcp-archive/feishu-cli-installation-guide.md
