本文由opencode的deepseek通过vscode+claudecode由以下视频提炼

飞书 CLI 快速上手指南：让 Agent 帮你搞定 95% 的飞书操作

从安装配置、基础用法、AI 工作流到 Skill 自动化——一篇讲透「怎么用」的实操经验分享

一、为什么 Agent 需要 CLI

最近「命令行界面」（CLI）成了很火的概念。你可能在 Windows 上打开过 PowerShell，或者用过最近爆火的 Claude Code——它们都是典型的命令行工具：通过敲命令来跟软件交互。但大部分人日常用的软件，其实是图形界面（GUI）。

两者的差异在哪里？以「用飞书给指定联系人发消息」为例：GUI 流程是「打开界面 → 找到按钮 → 找到联系人 → 输入内容 → 点击发送」，每一步都要人工点选；而底层真正的交互，其实是软件通过 API 调用飞书的服务器完成的。

有了 AI Agent 之后，我们天然希望 Agent 直接帮我们操作飞书界面。市面上有些产品用 computer use 的方式，靠截图识别图像、再决定点击哪里——你会发现一个简单步骤可能要经过很多轮推理，token 消耗大、效率也不高。

于是就有了更优的解法：飞书 CLI。它把飞书相关的 API 打包成更适合 AI 读取和使用的命令接口，让 Agent 直接与飞书本体交互。它的定位是 build for agent，而不是给普通人用的。理解这一点后你会发现：市面上大多数 CLI，本质上都是为 Agent 服务的。

一句话总结我们和 CLI 的关系：我们用 Agent 安装 CLI，也用 Agent 使用 CLI——两者像「超级套娃」。

二、安装飞书 CLI

安装其实很简单，推荐用 Agent 帮你装，具体 4 步：

• 1. 准备一个你最常用的 Agent（Claude Code、Codex、Warp 等都可以）。

• 2. 打开浏览器访问飞书 CLI 官网（搜索「飞书 CLI」即可找到）。官网提供「手动安装」和「通过 Agent 安装」两种方式，推荐后者。

• 3. 把官网给出的提示词复制，粘贴给你的 Agent 并发送。新用户它会返回一个一次性的飞书链接。

• 4. 打开链接跳转到飞书开放平台，创建应用并填写名称；在「自动完成所有配置」中确认权限后点击「创建」，即完成基本配置。

注意：配置里有两类权限——应用身份权限（bot 身份，权限较低）和用户身份权限（以你的身份操作，权限更高）。先全选创建，两类权限的差异我们放到第四节细说。

三、基础用法：单点提效实战

飞书 CLI 几乎覆盖 95% 以上的飞书日常操作：搜索/发送消息、创建/读取/评论文档、创建电子表格、多维表格、查看日历、写邮件、创建会议/任务、查询用户……能力还在持续扩展。下面用 5 个真实案例演示「怎么用」。

案例一：绘制组织架构图

直接对 Agent 说：「帮我绘制一张大型企业组织架构图。」Agent 会调用飞书画板能力，最终生成一个飞书文档链接，打开即是完整画好的架构图。需要画流程图、架构图、组织架构图时，都可以试试这个组合。

案例二：查询今日日程

对 Agent 说：「帮我检查一下我今天的日程。」Agent 会调用「查看飞书日历」的 skill，底层调用日历 API，返回你今天的安排；没有安排也会如实告诉你。

案例三：文档分析与总结

直接把飞书文档链接发给 Agent，让它分析重点、提炼总结，它还能把结果生成一份新的飞书文档返回给你。

案例四：构建多维表格

比如对 Agent 说：「帮我建一个客户信息管理表，包含公司名称、联系人、手机号，客户状态分 3 种；再创建「全部客户/潜在客户/沟通中/已合作」几个常用视图。」Agent 会一次性建好表格、字段和视图，字段属性与内容自动匹配，完全替代手动建表的繁琐过程。

案例五：更新群公告

对 Agent 说：「帮我在 XX 群里新增一条公告：……」如果 Agent 缺少权限，会弹出一个授权链接；复制打开，勾选所需权限（如获取群组信息、查看群公告、更新群公告），点击「开通并授权」即可，公告随后就更新好了。

经验之谈：大量使用后你会发现，很多操作需要先授权对应权限。有两种方式：一是「用到再开」（Agent 提醒 → 你授权）；二是「提前批量开」（主动去开放平台开通好大部分权限，用起来更丝滑）。后面第四节展开。

四、权限管理：两类身份与 Token 机制

访问飞书开放平台 → 开发者后台 → 找到你创建的应用 → 左侧「权限管理」，即可看到当前应用的全部权限，也可以在这里主动开通新权限。

应用身份 vs 用户身份

• 应用身份权限：相当于一个独立的 bot/机器人，权限级别较低。

• 用户身份权限：bot 以「你」的身份发消息、做操作，权限更高，能看到你的文档、邮箱等相对私密的信息。

日常建议：按场景给 Agent 开通部分用户身份权限（如获取群组信息、以用户身份建群/解散群/群内发言），权限越多它能帮你做的事越多；如果因公司规定比较保守，就只开应用身份权限下需要的板块即可。提前批量开通，用起来会更丝滑。

Token 有效期机制

飞书 CLI 的权限刷新有「两套 token」：

• access token（访问令牌）：像酒店房卡，约 2 小时失效。

• refresh token（刷新令牌）：像找前台帮你重刷房卡，有效期约 7 天。

只要 7 天内你正常使用过飞书 CLI，access token 失效后它都会自动通过 refresh token 换新，权限一直保留；超过一周未使用，权限不再保留，下次需要重新授权。所以「授权一次就永久有效」的安全顾虑可以放下——权限是有时效的。

五、复合用法：把多个能力串成 AI 工作流

单点提效始终有限，飞书 CLI 真正的魅力在于把多个能力串成一条完整的工作流。

Case 1：一份文档的全流程协作

场景：你写了份教学文档，要跟同事讨论。你需要：约会议 → 同步日历 → 发邮件提醒 → 创建任务让对方会前读文档。

具体做法——直接对 Agent 说（自然语言即可）：「这是一份飞书文档，先给对方创建一个任务，告诉他明天开会前先看一下；再约一个会议、创建日程；最后发一封邮件提醒他。」

Agent 会一次性完成 4 件事：

• 飞书任务：给对方建好「明天下午 5:30 前阅读文档」的任务——它甚至会注意到会议是 6 点开始，把截止时间往前提到 5:30。

• 日历：创建明天 18:00–19:00 的会议日程。

• 视频会议：自动生成会议链接。

• 邮箱：把含文档链接和会议时间的邮件发给对方。

这类多步长任务，建议选性能较好的模型（比如 Codex + 能力强的大模型）；模型较弱可能在执行中途丢失状态。

Case 2：公开课报名管理系统（表格 + 自动化流程）

场景：办一场公开课，需要一套报名管理系统——个人端、企业端两张报名表加常用视图；还要每天自动巡检「谁没付款/谁没签合同/谁信息缺失」，生成日报推给运营，并创建每日任务提醒运营更新表格。

发给 Agent 的指令依然很简短：「创建一个多维表格『XX 公开课报名管理』，里面两张表（个人报名表/企业报名表），表头如下……，创建常用视图……；每天 6 点检查未付款、未签合同、信息缺失的记录，更新日报（含待付款个人/企业人数），推给运营，并创建飞书任务提醒运营每天 6 点前更新。」

Agent 跑了约 24 分钟，一次交付：

• 两张报名表：字段完善（ID、姓名、微信名、手机号、邮箱、付款状态、公司名、参课人数等），付款状态区分「待付款/已付款/无需付款」。

• 常用视图：个人表自带「待付款」「待签合同」快速筛选视图。

• 自动化流程「每日公开课报名巡检」：每天 18:00 触发 → 统计个人/企业待付款人数、待签合同数、信息缺失记录 → 把巡检日报发给运营。

• 飞书任务：每天 6 点前提醒运营更新表格。

这套流程以前自己搭非常麻烦，现在借助 CLI + Agent 一次性全打通。如果你的企业有很多流程构建在飞书上，强烈建议把飞书 CLI 嵌进日常工作流。

六、进阶提效：把流程打包成 Skill

像「每天早上：读日程/任务/邮箱 → 分析优先级 → 生成今日建议 → 发到指定群」这种任务重复性极强——今天、明天、后天都要跑。以前我们保存成 prompt，现在有更优解：Skill。

具体做法 4 步：

• 1. 先用自然语言让 Agent 跑通整套流程，确认效果（比如生成「今日工作建议」并发送到指定群）。

• 2. 使用飞书官方提供的 lark skill maker，对 Agent 说：「把刚才这套流程用 lark skill maker 做成一个固定的 skill。」

• 3. Agent 会生成一个规范命名的 skill（如 lark-workflow-daily-assistant），把「查今日日程/未完成任务/近三天未读重要邮件 → 优先级分析 → 搜索目标群 → 发送群消息」固化下来。

• 4. 以后触发有 2 种方式：手动触发——每天直接告诉 Agent「启动一下这个 skill」；自动触发——用支持定时任务的 Agent（如 Codex、Warp），把它设成每天早上 9:00 自动执行的定时任务，实现全自动化。

提醒：创建 skill 时建议显式指定用 lark skill maker，避免被通用的 skill creator 抢活——飞书官方的原 skill 对飞书流程的适配度更高。

七、官方最佳实践清单

这里整理几个官方/社区公认的落地场景，照着做就能用：

• 会议纪要全流程：读取会议记录 → 识别待办 → 新建文档 → 发送文档 → 约会议 → 做调研，一站式搞定。

• 人机共创文档：AI 起草你来把关，或你来起草 AI 当审稿人。

• 跨时区多人智能约会议：5 个人约会，手动翻日历找空档太麻烦，让 Agent 同步所有人日历，自动找出合适空档安排会议。

• 会议数据沉淀仪表盘：会议开完，把相关数据同步到飞书多维表格，形成直观仪表盘。

• 邮件智能分拣：让 Agent 逐封读你每天几十封邮件，分析优先级、区分通知/审批，重要摘要推送到群聊，低优先级自动归档。

八、总结与展望

把流程描述清楚，直接让 Agent 结合飞书 CLI 去实现，需要权限就开通，基本能覆盖你 90% 以上的日常工作。别小看这些琐碎工作——把它们自动化后，效率提升非常可观。

最后说趋势。软件发展正走向两个方向：

• build for human：仍以 GUI 为核心载体，大部分普通人更愿意用有界面的软件。

• build for agent：一部分软件会专门为 Agent 调优，方便 Agent 调用。

CLI 属于第二类。飞书 CLI、钉钉 CLI、企业微信 CLI 都是同一套逻辑——当你理解了 CLI 的底层逻辑、会用飞书 CLI，基本就能一通百通。CLI 是很大的趋势，越早掌握，越能抢占先机。