如何让 AI 助手直接操作你的飞书办公套件？—— 飞书官方 lark-cli 工具深度指南
核心问题：如何将你的 AI 编程助手（如 Claude Code 或 Droid）直接连接到飞书，让它能帮你处理日程、发送消息、管理文档和整理表格数据？
飞书官方推出的命令行工具 lark-cli，通过提供超过 200 条命令、覆盖 11 个核心业务模块和 19 个 AI Agent 技能，为这个问题提供了官方、标准且安全的解决方案。本文将带你全面了解其能力、实操部署、核心架构与实际应用场景。
图片来源：Unsplash
一、工具全景：lark-cli 能做什么？
本节核心问题：lark-cli 究竟连接了飞书的哪些功能，又能让 AI Agent 完成什么类型的任务？
lark-cli 是飞书官方推出的命令行接口工具，它本质上是一座桥梁，将飞书开放的 API 能力以一种结构化、可编程的方式暴露给终端和 AI 智能体。其核心价值在于，将传统上需要通过图形界面点击完成的复杂操作，转化为了可被脚本和 AI 调用的原子化命令。
该工具的能力范围通过一张架构图可以清晰感知：
1.1 核心能力模块
工具覆盖了飞书生态中最常用的 11 个核心模块，每个模块都提供了一系列完整的命令：
| 模块图标 | 模块名称 | 核心功能简述 |
|---|---|---|
| 📅 | 日历日程 | 查看日程、创建会议、邀请参会人、查询忙闲状态、智能推荐时间。 |
| 💬 | 即时通讯 | 发送/回复消息、创建与管理群组、查询聊天记录、搜索消息、下载文件与图片。 |
| 📝 | 云文档 | 创建、读取、更新、搜索文档，支持 Markdown 格式输入输出。 |
| 📁 | 云空间 | 上传/下载文件、管理文件权限、为文档添加评论。 |
| 📊 | 多维表格 | 创建表格、管理字段、进行数据的增删改查、配置视图、进行数据聚合分析。 |
| 📈 | 电子表格 | 读写单元格、追加数据、查找内容、导出文件。 |
| ✅ | 任务管理 | 创建待办事项、拆分子任务、设置提醒、分配成员。 |
| 📚 | 知识库 | 创建知识空间、管理文档节点、组织目录结构。 |
| 📧 | 邮件 | 浏览、搜索、读取邮件；发送、回复、转发邮件；管理草稿。 |
| 👤 | 通讯录 | 按姓名、邮箱或手机号搜索人员，查看组织架构。 |
| 🎥 | 视频会议 | 搜索会议记录、查询会议纪要（包括总结、待办事项和逐字稿）。 |
重要说明：这是飞书官方开源项目（MIT 协议），由官方团队维护，这意味着其稳定性、安全性和对飞书 API 的跟踪更新有根本保障。
1.2 从命令到 AI 技能
对于普通用户，lark-cli 提供了 200 多条直接可用的命令。而对于 AI 集成，其核心在于“技能”概念。工具打包提供了 19 个 AI Agent Skills，这些 Skills 本质上是关于如何使用这 200 多条命令的详细说明文档。
当你在 Claude Code 或 Droid 等工具中安装了这些 Skills 后，AI 就“学会”了如何操作飞书。你只需用自然语言提出需求，AI 会自动查阅 Skills，找到并执行相应的命令序列。
二、实操场景：从手动操作到自然语言控制
本节核心问题：在日常工作中，利用 lark-cli 和 AI 具体能解决哪些痛点，带来怎样的效率提升？
以下三个场景展示了从“打开飞书应用 → 点击多个菜单 → 执行操作”的传统模式，到“一句话 → AI 自动执行”的新模式的转变。
场景一：知识库文档的快速检索与管理
痛点：公司或团队的知识库文档越来越多，层级复杂。想快速找到某个主题的相关文档，或了解某个知识库空间的整体结构，需要多次点击和翻页，效率低下。
传统方式：打开飞书 → 点击“知识库”图标 → 在列表中找到目标空间 → 逐级展开目录 → 浏览或搜索。
lark-cli + AI 方式：直接告诉 AI：“列出我的‘AI搞钱’知识库里的所有文档。” AI 会调用 lark-cli 的 Wiki 模块命令，返回清晰的节点列表。
上图展示了 AI 返回的结果，清晰列出了某个知识空间下所有文档和多维表格节点，包括其类型（docx、bitable）和子文档数量。这相当于为知识库生成了一张实时更新的“目录地图”，支持后续进行批量移动、重命名或内容分析。
场景二：技术社群消息的智能提炼
痛点：加入的多个技术讨论群消息刷屏速度极快，每天产生数百条消息。想要了解核心讨论内容、是否有解决重要问题，需要花费大量时间“爬楼”阅读，容易遗漏关键信息。
传统方式：群内设置消息免打扰，空闲时逐条滑动阅读，或依赖群内的置顶消息和@提醒。
lark-cli + AI 方式：对 AI 说：“总结一下‘OpenClaw开发者交流群’昨天的讨论要点。” AI 能够获取指定群聊的近期消息记录，并利用其语言理解能力进行提炼总结。
如图所示，AI 生成了结构化的总结报告，包含“分享内容”、“高频技术问题”及对应的“排查/解决方法”。这种从混乱信息到结构化知识的转换，极大提升了信息获取效率，让参与者能快速跟上项目进展或技术焦点。
反思与见解：这种场景让我们看到，AI 不仅是操作执行者，更是信息的“结构化引擎”。它解放了用户从噪声中提取信号的脑力，让协作真正回归到有价值的思考与决策本身。未来的办公软件，其价值可能越来越体现在“API 的友好程度”和“可被 AI 理解的颗粒度”上。
场景三：多维表格数据的批量整理与分析
痛点：在飞书多维表格中收藏了大量链接或数据，标签体系混乱，存在大量同义重复、格式不统一的条目，难以进行有效的分类统计和数据分析。
传统方式：导出表格到 Excel，进行繁琐的数据清洗，或手动在飞书内逐条修改，过程枯燥且易错。
lark-cli + AI 方式：将问题陈述给 AI：“帮我分析这个多维表格中‘标签’字段的问题，并给出整合建议。” AI 通过 lark-cli 的多维表格模块读取数据，进行分析后给出可执行的方案。
上图展示了 AI 返回的分析报告，清晰指出了“现状问题”（如标签同义重复、与网站强绑定、零散单条），并提供了“建议整合为15个大类”的具体方案，包括每个新分类应包含的原标签和预估数据量。这从一个侧面证明了，将数据操作能力开放给 AI 后，AI 能够承担起“数据分析师”的角色。
三、快速部署：四步完成从安装到集成
本节核心问题：需要哪些前置条件，以及具体如何操作才能在自己的电脑上配置好 lark-cli 并连接 AI 工具？
整个配置过程设计得非常人性化，大约只需 3-5 分钟。前提是你已安装 Node.js。以下是详细步骤。
步骤 1：安装 CLI 工具
打开你的终端（Terminal 或 CMD），执行以下命令进行全局安装：
npm install -g @larksuite/cli
安装完成后，你可以在终端运行 lark-cli --version 来检查是否成功。
步骤 2：一键配置飞书应用
这是初始化的关键步骤，它将帮你创建一个飞书自定义应用，并完成基础配置。
lark-cli config init
运行命令后，会出现交互式界面。
选择语言：
首先选择界面语言，例如选择“中文”。
选择配置方式：
接着选择“一键配置应用（推荐）”。这是最简单的方式。
扫码授权：
工具会生成一个二维码和一个配置链接。使用你安装了飞书的手机扫描二维码，或在浏览器中打开链接。
在浏览器打开的页面中，按照提示确认创建应用。完成后，终端会显示“OK: 应用配置成功！”以及分配的 App ID。
注意：确保用于扫码的飞书账号拥有租户管理员权限，否则可能无法成功创建应用。
步骤 3：用户登录授权
应用创建成功后，需要以你的个人身份进行登录授权，获取访问飞书数据的令牌。
lark-cli auth login --recommend
--recommend 参数会为你的应用申请一组经过筛选的常用权限范围，比申请全部权限更安全。
在终端输出的链接上，按住 Cmd（Mac）或 Ctrl（Windows）并点击，或手动复制到浏览器打开。在飞书网页中点击“允许”以授权。
授权成功后，终端会列出你已获得的权限列表，表示登录成功。
步骤 4：安装 AI Agent Skills
这是让 AI“读懂”lark-cli 并自动执行操作的决定性步骤。
npx skills add larksuite/cli -y -g
-g 参数表示全局安装，这样所有项目都能使用这些技能。-y 表示自动确认。
执行完毕后，你的系统就拥有了 lark-cli 提供的 19 个官方 Skills，涵盖了日历、消息、文档、表格、任务等所有核心模块。此刻，你的 Claude Code、Droid 或其他支持 Skills 的 AI 编程工具，就具备了操作你飞书账号的能力。
四、核心架构：三层命令模型
本节核心问题：lark-cli 的命令体系是如何设计的，我应该用哪一层来满足不同的需求？
为了平衡易用性和灵活性，lark-cli 设计了清晰的三层命令架构。理解这个架构有助于你在使用时做出恰当的选择。
| 命令层级 | 特点 | 适用场景 | 示例 |
|---|---|---|---|
| 第一层：快捷命令 | 以 + 为前缀，语义化强，参数少，封装了常见操作逻辑。 |
日常高频操作，AI Agent 自动调用。 | lark-cli calendar +agenda |
| 第二层：API 命令 | 更接近底层 API 结构，控制精确，选项完整。 | 需要更精细控制参数的场景。 | lark-cli calendar events list |
| 第三层：原始 API | 以 api 为前缀，直接调用飞书开放 API。 |
需要完全自定义请求，或使用尚未被封装的新 API。 | lark-cli api GET /open-apis/calendar/v4/events |
建议：对于普通用户和绝大多数 AI 自动化场景，第一层快捷命令是最佳选择。它足够简洁和直观。当需要指定更详细的参数（如特定的开始时间、自定义的字段值）时，可以使用第二层 API 命令。第三层原始 API 主要面向高级开发者和工具维护者。
五、进阶应用与安全考量
本节核心问题：在将飞书操作权交给 AI 后，有哪些实用技巧和必须注意的安全事项？
5.1 实用命令速查与自然语言控制
即便掌握了命令，在日常中也无需记忆。安装了 Skills 后，AI 就成为了你的自然语言操作入口。
常用快捷命令示例：
# 查看今天日程
lark-cli calendar +agenda
# 发送群消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "大家好"
# 创建 Markdown 文档
lark-cli docs +create --title "项目周报" --markdown "# 本周进展\n- 完成了模块A开发"
# 搜索文档
lark-cli docs +search --query "市场分析报告"
# 查看待办任务
lark-cli task +get-my-tasks
# 浏览知识库目录
lark-cli wiki nodes YOUR_SPACE_ID
自然语言指令示例：
安装 Skills 后，你可以直接对 AI 说：
-
“帮我把明天的会议改到下午 3 点，并提醒所有参会人。” -
“在‘产品规划’多维表格里新增一条记录：功能名称是‘AI 智能摘要’，优先级是‘高’。” -
“找到我上个月创建的所有包含‘合同’字样的文档，并生成一个列表。”
5.2 安全操作指南
让 AI 拥有操作你飞书账号的权限，安全是首要考虑。官方提供了一些最佳实践：
-
最小权限原则：使用 lark-cli auth login --recommend授予权限，而非--all。仅申请完成任务所必需的权限范围。 -
私人助手定位：官方建议将集成了 lark-cli的 AI Agent 作为私人智能助手使用，避免将其添加到公共群组或让他人随意触发，以防信息泄露。 -
敏感操作复核：对于删除、发送、批量修改等不可逆或影响较大的操作，建议在 AI 执行前进行人工确认。可以在提示词中明确要求 AI 在执行此类操作前征得你的同意。 -
凭据安全存储： lark-cli默认使用操作系统级别的钥匙串（如 macOS 的 Keychain、Windows 的 Credential Manager）来安全存储访问令牌，而非明文配置文件，这提供了基础的安全保障。
反思与见解：在 AI 辅助办公的时代，我们正在经历一个范式转移：从“人操作软件”到“人向 AI 描述目标，AI 操作软件”。在这个过程中，权限管理和审计变得前所未有的重要。飞书官方推出的 lark-cli 及其 Skills 机制，提供了一个开放、可控且安全的范例，这可能是未来企业软件“AI-Ready”演进的必经之路。
六、总结与展望
飞书官方推出的 lark-cli 工具，通过 200+ 条命令、19 个 AI Skills 和三层命令架构，成功地将飞书从一款图形化办公软件，升级为一个可被 AI Agent 直接编程和操作的自动化平台。
其核心价值在于：
-
官方支持：开源且由飞书团队维护，保障了安全性和持续更新。 -
无缝集成：专为 Claude Code、Droid 等 AI 编程工具设计，实现自然语言到飞书操作的直连。 -
场景落地：从知识库管理、信息提炼到数据整理，切实解决了信息过载和重复劳动的痛点。 -
架构清晰：分层设计兼顾了易用性与灵活性，满足从新手到专家的不同需求。
当你看到 AI 在终端里安静地执行命令，然后飞书里的文档自动生成、日程自动排期、数据自动整理时，你会真切感受到：人机协作的新形态已经到来。你的 AI 编程助手，已然成为你最得力的飞书办公助手。
实用摘要 / 操作清单
-
安装 Node.js：确保你的电脑已安装 Node.js 环境。 -
全局安装 lark-cli： npm install -g @larksuite/cli -
初始化配置：运行 lark-cli config init，扫码创建并配置飞书应用。 -
用户登录：运行 lark-cli auth login --recommend，在浏览器中完成授权。 -
安装 AI Skills：运行 npx skills add larksuite/cli -y -g，让 AI 学会操作飞书。 -
开始使用：在你的 AI 编程工具中，直接用自然语言下达与飞书相关的指令。
一页速览
| 项目 | 内容 |
|---|---|
| 工具名称 | lark-cli (飞书官方命令行工具) |
| 核心能力 | 200+ 命令，覆盖飞书 11 大模块（日历、消息、文档、表格、任务、知识库、邮件、会议等） |
| AI 集成 | 提供 19 个 AI Agent Skills，支持 Claude Code、Droid 等工具 |
| 关键价值 | 将飞书操作转化为可编程、可被 AI 自动调用的原子化任务 |
| 安装命令 | npm install -g @larksuite/cli |
| 配置流程 | config init → 扫码创建应用 → auth login --recommend → 安装 Skills |
| 命令架构 | 快捷命令(+)、API 命令、原始 API 三层 |
| 安全建议 | 使用最小权限原则，作为私人助手使用，敏感操作需确认 |
常见问答
Q1：使用 lark-cli 需要付费吗？
A1：不需要。lark-cli 是飞书官方开源的工具，遵循 MIT 协议。你只需拥有飞书账号即可使用。
Q2：我没有技术背景，能用这个工具吗？
A2：核心安装步骤是简单的命令行操作，但主要用户定位是技术人员或开发者。安装 Skills 后，普通用户可以通过与 AI 对话来间接使用，无需直接敲命令。
Q3：AI 操作我的飞书安全吗？会不会泄露数据？
A3：安全性取决于你授予的权限和操作习惯。请遵循最小权限原则，仅授予 --recommend 权限，并将 AI Agent 作为私人工具使用，不要添加到公共群。所有访问令牌都安全存储在操作系统钥匙串中。
Q4：除了 Claude Code 和 Droid，还能用在其他 AI 上吗？
A4：lark-cli 提供的 Skills 是标准化的文档。理论上，任何能够读取并执行这些 Skills 说明的 AI Agent 都可以使用。具体支持列表需查看该 AI 工具的文档。
Q5：如果飞书更新了功能，这个工具会跟不上吗？
A5：lark-cli 由飞书官方团队维护，会随着飞书开放平台的更新而迭代。你只需定期运行 npm update -g @larksuite/cli 来获取最新版本。
Q6：我只想发条消息，为什么需要这么多步骤？
A6：初始安装和配置是一次性工作。配置完成后，发消息只需对 AI 说一句话。工具的强大在于其通用性和可组合性，能自动化复杂的、批量的事务，而不仅仅是单次操作。
Q7：支持个人版飞书吗？
A7：根据工具描述，其核心是连接企业版飞书的开放平台能力。对于个人版飞书的支持情况，请查阅 lark-cli 的最新 GitHub 文档。
Q8：如何获取具体命令的帮助文档？
A8：在命令后加 --help，例如 lark-cli calendar +agenda --help，即可查看该命令的详细参数说明。
