从一个小需求说起上礼拜我想搞个自动化的东西每天早上把我在飞书里的当天日程拉下来整理成一句话扔进群里。放到以前这条路是这样的先去飞书开放平台建个自建应用就是给公司/个人在飞书后台注册一个程序身份调接口都用它的名义然后翻 API 文档、拼请求头、处理 token 过期再写百来行胶水代码专门把几个系统粘在一起、没什么业务逻辑的那种代码最后还得找台机器挂着跑。写到一半我想起之前刷到过飞书官方自己出的命令行工具lark-cli就顺手装了一下。结果发现上面那件事装好配置完核心就是一两条命令的事。所以这篇不聊宏大叙事就说说这东西是什么、怎么用、哪些人值得装以及我踩着看到的几个注意点。项目地址https://github.com/larksuite/cli协议MIT可以随便改随便用包括商用数据截至 2026 年 10 月17.5k Star / 1.4k Fork最新版本 v1.0.979 月底发的更新挺勤它到底是个啥飞书的万能遥控器一句话lark-cli 是飞书/Lark 官方出的命令行工具把发消息、查日程、建文档、改表格这些操作变成了终端里的一条条命令。打个比方飞书的各个功能像一台台电器开放平台 API飞书官方暴露出来、允许外部程序调用的功能入口就是每台电器背后的插座——能用但电压规格各不相同每次都得看说明书。lark-cli 相当于给你一个万能遥控器按键是标准化的按下就行不用关心背后接的是哪根线。我翻了下它的 README覆盖 11 个业务域、200 多条命令大概是这么个盘子业务域能干嘛举几个例子IM消息发消息、回消息、搜聊天记录、管群成员、传图传文件日历查日程、建日程、忙闲查询、找会议室文档 Docs用 Markdown 建文档、读写改文档多维表格 Base建表、增删字段和记录、视图、仪表盘电子表格 Sheets读写单元格、追加、导出云盘 Drive上传下载文件、管权限和评论邮箱 Mail收发、搜索邮件、管草稿任务 Tasks待办、清单、子任务、提醒知识库 Wiki空间、节点、文档通讯录 Contact按姓名/邮箱/手机号找人会议 Meetings查会议记录、分析妙记逐字稿三分钟上手装好到跑通第一条命令实测三步。前提是有 npmNode.js 自带的包管理器不懂就当命令行版的应用商店。# 1. 安装 npm install -g larksuite/cli # 2. 配置应用凭证交互式引导帮你创建或绑定一个飞书自建应用 lark-cli config init # 3. 登录授权--recommend 会自动勾选一组常用权限不用一个个找 lark-cli auth login --recommend # 验证登录状态 lark-cli auth status # 第一条命令看看今天的日程 lark-cli calendar agenda两个提醒要有飞书租户的管理员配合。自建应用要开权限公司账号可能得走管理员审批个人版自己就是管理员没这个问题。想给 Cursor、Claude Code 这类 AI 编程工具用的话官方还要求装一套 Skill 包后面细说npx skills add larksuite/cli -y -g最有意思的设计三层命令体系这是我觉得这项目最值得说的部分。同样一件事它给你三种力度层级长什么样什么时候用快捷命令 Shortcutslark-cli calendar agenda日常办事。开头内置智能默认值和好看的表格输出API 命令lark-cli calendar calendars list跟平台接口一一对应100 条精选命令适合要精确对齐文档的场景通用调用 Raw APIlark-cli api GET /open-apis/...前两层覆盖不到的直接裸调能覆盖 2500 个开放接口拿同一个发消息/查数据举例三层长这样# 快捷命令发一条群消息 lark-cli im messages-send --chat-id oc_xxx --text Hello # API 命令列出我的日历 lark-cli calendar calendars list # 通用调用直接裸调接口 lark-cli api POST /open-apis/im/v1/messages --params {receive_id_type:chat_id} --data {receive_id:oc_xxx,msg_type:text,content:{\text\:\Hello\}}感受一下区别第一条人话就能看懂第三条就是 API 文档里的原始样子参数全自己拼。平时用第一层兜底用第三层——这个分层比一个工具硬塞两千个命令舒服多了。给 AI 准备的那一半这个项目 README 的第一句话是 Built for humans and AI Agents——一半给人用一半给 AI Agent能自己规划步骤、调用工具完成任务的 AI 程序比如 Cursor、Claude Code用。给 AI 的部分是 23 个 Agent Skill我数了下 README 里的表格。装好之后AI 写代码时就知道这些命令怎么调不用它自己瞎猜——这解决的是个很实际的痛点让 AI 调飞书接口最常见的幺蛾子就是它一本正经地编一个不存在的接口。挑几个实用的Skill干嘛的lark-calendar日程增删改、忙闲、会议室lark-im发消息、管群、搜记录、传文件lark-doc/lark-sheets/lark-base文档、电子表格、多维表格全家桶lark-mail/lark-task邮件、待办lark-meeting会议记录、妙记逐字稿分析lark-okrOKR 查询与更新lark-openapi-explorer让 AI 自己去官方文档翻接口完整 23 个的清单直接看仓库 README 的 Agent Skills 一节。几个我觉得贴心的细节输出格式随便切方便脚本和 AI 解析--format json # 完整 JSON默认 --format pretty # 人性化排版 --format table # 人看的表格 --format ndjson # 一行一个 JSON适合管道处理 --format csv顺带记一个坑JSON 模式下判断命令成功没成功要看ok字段是不是true或者进程退出码别去判断code 0——这跟飞书原始接口的习惯不一样README 专门强调过。身份切换同一条命令可以在我和机器人两种身份之间切lark-cli calendar agenda --as user lark-cli im messages-send --as bot --chat-id oc_xxx --text Hello怕误操作就先彩排# --dry-run 只打印将要发出的请求不真发 lark-cli im messages-send --chat-id oc_xxx --text hello --dry-run翻页不用自己写循环--page-all一口气拉完所有页还能用--page-limit、--page-delay控制最多翻几页、每页间隔多久。忘记参数直接问它不用开浏览器查文档lark-cli schema im.messages.delete它会把这个接口的参数、请求体、需要的权限范围全列出来。泼点冷水安全这件事得自己上心这部分 README 自己写得挺直白我觉得必须转述。lark-cli 授权之后AI 在授权范围内就是以你的身份在操作飞书——它能读你的消息也能以你的名义发消息。由此带来几个真实的风险AI 会犯错。模型幻觉AI 一本正经地说错话可能让它调错接口、发错内容提示词注入。如果有人往群消息、文档里塞了恶意指令AI 读到之后可能照做所以官方明确建议别把接了这个工具的机器人拉进不可信的群聊也别随手放宽默认安全策略。另外授权是按 scope权限范围可以理解成这把钥匙能开哪几扇门来的--recommend图省事授权的那组常用权限可能比你实际需要的宽。我的建议个人玩随意公司环境里按最小权限来——先跑lark-cli auth scopes看看都有什么再挑真正用得到的。顺带一提新版本默认给本地凭证启用了 DPoP一种给访问凭证加防伪签名的机制凭证被偷了别人也冒用不了这点做得挺到位。适合谁用想把飞书日常操作脚本化的人日程汇总、群通知、表格同步这类活要给 AI 工具配飞书能力的团队官方 Skill 比自己从零写封装省太多事经常对接飞书接口的后端第三层的裸调用可以直接当调试器使。不太适合的只是自己用飞书、完全没有自动化需求的普通用户——装它纯属多余。名词速查表名词一句话解释CLI命令行工具在终端那个黑窗口里敲命令干活的程序Open API / 开放平台接口飞书官方暴露出来的、允许外部程序调用的功能入口自建应用在飞书管理后台创建的程序身份调接口都用它的名义OAuth一种授权方式你点头同意后程序拿到临时通行证去访问你的数据Scope权限范围类似一把钥匙能开哪几扇门Token访问凭证可以理解为临时通行证AI Agent能自己规划步骤、调用工具完成任务的 AI 程序Agent Skill预先写好的使用说明书让 AI 知道某类工具该怎么调npmNode.js 的包管理器命令行版的应用商店多维表格Base飞书里类似 Airtable 的表格 数据库混合体DPoP给访问凭证加防伪签名的机制防止凭证被冒用Dry-run彩排模式只显示会做什么不真做相关链接GitHub 仓库https://github.com/larksuite/clinpm 包https://www.npmjs.com/package/larksuite/cli中文 READMEhttps://github.com/larksuite/cli/blob/main/README.zh.md飞书开放平台https://open.feishu.cn/