在我用 AI 搭建跑团知识库的时候,我用的是飞书。 我需要让 AI 连接飞书帮我搭建知识库,方便其他人公开阅读。这个时候,飞书刚好有一个飞书 CLI 可以实现。 飞书里发消息、建表格、约会议,每一步都能通过飞书 CLI 交给 Agent,这些日常操作说一句话就能帮你做完,覆盖 95% 以上的飞书操作。
一、安装飞书 CLI
安装其实很简单,推荐用 Agent 帮你装,具体 4 步:
- 打开浏览器访问飞书 CLI 官网(搜索「飞书 CLI」即可找到)。官网提供「手动安装」和「通过 Agent 安装」两种方式,推荐后者。
- 把官网给出的提示词复制,粘贴给你的 Agent 并发送。新用户它会返回一个一次性的飞书链接。
- 打开链接跳转到飞书开放平台,创建应用并填写名称;在「自动完成所有配置」中确认权限后点击「创建」,即完成基本配置。
注意:配置里有两类权限——应用身份权限(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 步:
- 先用自然语言让 Agent 跑通整套流程,确认效果(比如生成「今日工作建议」并发送到指定群)。
- 使用飞书官方提供的 lark skill maker,对 Agent 说:
把刚才这套流程用 lark skill maker 做成一个固定的 skill。- Agent 会生成一个规范命名的 skill(如
lark-workflow-daily-assistant),把「查今日日程/未完成任务/近三天未读重要邮件 → 优先级分析 → 搜索目标群 → 发送群消息」固化下来。 - 以后触发有 2 种方式:手动触发——每天直接告诉 Agent「启动一下这个 skill」;自动触发——用支持定时任务的 Agent(如 Codex、Warp),把它设成每天早上 9:00 自动执行的定时任务,实现全自动化。
提醒:创建 skill 时建议显式指定用 lark skill maker,避免被通用的 skill creator 抢活——飞书官方的原 skill 对飞书流程的适配度更高。