飞书 CLI 终极指南：18 大业务域全覆盖，从消息到会议 200+ 命令
2026/7/17大约 6 分钟
飞书 CLI 能做哪些事？
18 大业务域，200+ 命令，覆盖飞书全部能力
从消息、文档到会议、审批，一网打尽
三层调用架构，从快捷命令到全 API 覆盖
来源：飞书官方 CLI，larksuite 团队维护
业务覆盖全景
18 大业务域，200+ 精选命令
┌─────────────────────────────────────────────────────────┐
│ 18 大业务域，200+ 命令 │
├─────────────────────────────────────────────────────────┤
│ │
│ 📅 日历（Calendar） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 查看、创建和更新日程 │ │
│ │ · 邀请参会人 │ │
│ │ · 查找会议室 │ │
│ │ · 回复日程邀请 │ │
│ │ · 查询忙闲与时间建议 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli calendar +agenda │ │
│ │ lark-cli calendar events create │ │
│ │ lark-cli calendar calendars list │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 💬 即时通讯（Messenger） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 发送/回复消息 │ │
│ │ · 创建和管理群聊 │ │
│ │ · 查看聊天记录与话题 │ │
│ │ · 搜索消息 │ │
│ │ · 下载媒体文件 │ │
│ │ │ │
│ │ 命令示例： │ │"
│ │ lark-cli im +messages-send --chat-id "oc_xxx" │ │
│ │ lark-cli im messages list │ │
│ │ lark-cli im groups create │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📄 云文档（Docs） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建、读取、更新文档 │ │
│ │ · 搜索文档 │ │
│ │ · 读写素材与画板 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli docs +create │ │
│ │ lark-cli docs list │ │
│ │ lark-cli docs get --doc-id "xxx" │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📁 云空间（Drive） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 上传和下载文件 │ │
│ │ · 搜索文档与知识库 │ │
│ │ · 管理评论 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli drive upload │ │
│ │ lark-cli drive download │ │
│ │ lark-cli drive files list │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📝 Markdown（Markdown） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建 Drive 中的原生 .md 文件 │ │
│ │ · 读取 Markdown 文件 │ │
│ │ · 局部 patch │ │
│ │ · 覆盖更新 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli markdown create │ │
│ │ lark-cli markdown get │ │
│ │ lark-cli markdown patch │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📊 多维表格（Base） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建和管理数据表 │ │
│ │ · 管理字段、记录、视图 │ │
│ │ · 管理仪表盘 │ │
│ │ · 自动化流程 │ │
│ │ · 表单、角色权限 │ │
│ │ · 数据聚合分析 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli base tables create │ │
│ │ lark-cli base records list │ │
│ │ lark-cli base fields create │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📈 电子表格（Sheets） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建、读取、写入电子表格 │ │
│ │ · 追加数据 │ │
│ │ · 查找数据 │ │
│ │ · 导出表格 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli sheets create │ │
│ │ lark-cli sheets read │ │
│ │ lark-cli sheets write │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🖼️ 幻灯片（Slides） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建和管理演示文稿 │ │
│ │ · 读取演示文稿内容 │ │
│ │ · 新增或删除幻灯片页面 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli slides create │ │
│ │ lark-cli slides get │ │
│ │ lark-cli slides pages create │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ✅ 任务（Tasks） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建、查询、更新和完成任务 │ │
│ │ · 管理任务清单 │ │
│ │ · 管理子任务 │ │
│ │ · 管理评论与提醒 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli task create │ │
│ │ lark-cli task list │ │
│ │ lark-cli task complete │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📚 知识库（Wiki） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建和管理知识空间 │ │
│ │ · 管理节点和文档 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli wiki spaces create │ │
│ │ lark-cli wiki nodes create │ │
│ │ lark-cli wiki items create │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 👤 通讯录（Contact） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 按姓名/邮箱/手机号搜索用户 │ │
│ │ · 获取用户信息 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli contact search --name "张三" │ │
│ │ lark-cli contact get --user-id "xxx" │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📧 邮箱（Mail） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 浏览、搜索、阅读邮件 │ │
│ │ · 发送、回复、转发邮件 │ │
│ │ · 管理草稿 │ │
│ │ · 监听新邮件 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli mail list │ │
│ │ lark-cli mail send │ │
│ │ lark-cli mail reply │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🎥 视频会议（Meetings） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 搜索会议记录 │ │
│ │ · 查询会议纪要产物 │ │
│ │ · 查询会议录制 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli vc records search │ │
│ │ lark-cli vc minutes get │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🕐 考勤打卡（Attendance） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 查询个人考勤打卡记录 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli attendance records list │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ✍️ 审批（Approval） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 查询审批任务 │ │
│ │ · 同意/拒绝/转交审批任务 │ │
│ │ · 撤回与抄送审批实例 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli approval tasks list │ │
│ │ lark-cli approval approve │ │
│ │ lark-cli approval reject │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🎯 OKR（OKR） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 查询、创建、更新 OKR │ │
│ │ · 管理目标、关键结果 │ │
│ │ · 管理对齐、指标和进展记录 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli okr list │ │
│ │ lark-cli okr create │ │
│ │ lark-cli okr update │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 📋 飞书项目（Project） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 管理工作项、排期与数据 │ │
│ │ · 由独立的 meegle-cli 提供（需单独安装） │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 🔗 应用（Apps） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 能力： │ │
│ │ · 创建妙搭（Spark/Miaoda）应用 │ │
│ │ · 发布 HTML/静态站点 │ │
│ │ · 云端生成迭代 │ │
│ │ · 管理可用范围 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘三层调用架构
从快捷命令到全 API 覆盖
┌─────────────────────────────────────────────────────────┐
│ 三层调用架构 │
├─────────────────────────────────────────────────────────┤
│ │
│ 第 1 层：快捷命令（Shortcuts） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 特点： │ │
│ │ · 以 + 为前缀 │ │
│ │ · 对人类与 AI 友好化封装 │ │
│ │ · 内置智能默认值 │ │
│ │ · 表格输出 │ │
│ │ · dry-run 预览 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli calendar +agenda │ │
│ │ lark-cli im +messages-send --chat-id "oc_xxx" │ │
│ │ lark-cli docs +create │ │
│ │ │ │
│ │ 适用场景： │ │
│ │ · 快速操作 │ │
│ │ · 日常使用 │ │
│ │ · Agent 调用 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 第 2 层：API 命令（API Commands） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 特点： │ │
│ │ · 从飞书 OAPI 元数据自动生成 │ │
│ │ · 经过评测与准入筛选 │ │
│ │ · 100+ 精选命令 │ │
│ │ · 与平台端点一一对应 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli calendar calendars list │ │
│ │ lark-cli calendar events instance_view │ │
│ │ lark-cli im messages list │ │
│ │ │ │
│ │ 适用场景： │ │
│ │ · 需要更多参数控制 │ │
│ │ · 需要精确控制 │ │
│ │ · API 对接 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 第 3 层：通用 API 调用（Raw API） │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 特点： │ │
│ │ · 直接调用任意飞书开放平台端点 │ │
│ │ · 覆盖 2500+ API │ │
│ │ · 完全自定义 │ │
│ │ · 最大灵活性 │ │
│ │ │ │
│ │ 命令示例： │ │
│ │ lark-cli api GET /open-apis/calendar/v4/calendars│ │
│ │ lark-cli api POST /open-apis/im/v1/messages │ │
│ │ │ │
│ │ 适用场景： │ │
│ │ · 需要调用未封装的 API │ │
│ │ · 需要完全自定义 │ │
│ │ · 高级用法 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 选择建议： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ · 日常使用 → 快捷命令 │ │
│ │ · 精确控制 → API 命令 │ │
│ │ · 完全自定义 → 通用 API 调用 │ │
│ │ · Agent 调用 → 快捷命令优先 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘进阶用法
输出格式、分页、Dry Run、Schema 自省
┌─────────────────────────────────────────────────────────┐
│ 进阶用法 │
├─────────────────────────────────────────────────────────┤
│ │
│ 输出格式： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ --format json # 完整 JSON 响应（默认） │ │
│ │ --format pretty # 人性化格式输出 │ │
│ │ --format table # 易读表格 │ │
│ │ --format ndjson # 换行分隔 JSON（管道处理） │ │
│ │ --format csv # 逗号分隔值 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ JSON 输出契约： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 成功信封（stdout，exit 0）： │ │
│ │ { │ │
│ │ "ok": true, │ │
│ │ "identity": "user", │ │
│ │ "data": { "guid": "..." }, │ │
│ │ "meta": { "count": 1 } │ │
│ │ } │ │
│ │ │ │
│ │ 错误信封（stderr，exit 1）： │ │
│ │ { │ │
│ │ "ok": false, │ │
│ │ "identity": "user", │ │
│ │ "error": { │ │
│ │ "type": "api", │ │
│ │ "subtype": "...", │ │
│ │ "code": 99991679, │ │
│ │ "message": "...", │ │
│ │ "hint": "..." │ │
│ │ } │ │
│ │ } │ │
│ │ │ │
│ │ 判断命令是否成功： │ │
│ │ · 检查 ok == true（或进程退出码） │ │
│ │ · 不要用 code == 0 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 分页： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ --page-all # 自动翻页获取所有数据 │ │
│ │ --page-limit 5 # 最多获取 5 页 │ │
│ │ --page-delay 500 # 每页请求间隔 500ms │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Dry Run： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 对可能产生副作用的命令，建议先用 --dry-run 预览： │ │
│ │ │ │
│ │ lark-cli im +messages-send --chat-id oc_xxx │ │
│ │ --text "hello" --dry-run │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Schema 自省： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 使用 schema 查看任意 API 方法的详细信息： │ │
│ │ │ │
│ │ lark-cli schema │ │
│ │ lark-cli schema calendar.events.instance_view │ │
│ │ lark-cli schema im.messages.delete │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘核心思想
18 大业务域，200+ 命令，覆盖飞书全部能力
┌─────────────────────────────────────────────────────────┐
│ 核心思想 │
├─────────────────────────────────────────────────────────┤
│ │
│ lark-cli 的业务覆盖： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 18 大业务域，200+ 精选命令，覆盖飞书全部能力 │ │
│ │ │ │
│ │ 从消息、文档到会议、审批，一网打尽 │ │
│ │ │ │
│ │ 三层调用架构，从快捷命令到全 API 覆盖 │ │
│ │ │ │
│ │ 按需选择粒度，满足不同场景需求 │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 这就是 lark-cli 的核心价值： │
│ ┌─────────────────────────────────────────────────┐ │
│ │ │ │
│ │ 飞书 CLI 终极指南！ │ │
│ │ │ │
│ │ 18 大业务域，200+ 命令，从消息到会议，一网打尽！ │ │
│ │ │ │
│ └─────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────┘收尾金句
- 飞书 CLI 能做哪些事？
- 18 大业务域，200+ 命令，覆盖飞书全部能力
- 从消息、文档到会议、审批，一网打尽
- 三层调用架构，从快捷命令到全 API 覆盖
飞书 CLI 终极指南：18 大业务域全覆盖，从消息到会议 200+ 命令！