用命令行管理飞书文档和日历

飞书/Lark 官方命令行工具，同时面向人类用户与 AI Agent，提供 200+ 命令和 26 个内置 Agent 技能，覆盖即时消息、文档、表格、多维表格、日历、邮件、任务、会议、审批、OKR 等核心业务域。三层命令体系（快捷命令、API 命令、原始 API 调用）可细到直接调用 2500+ 开放平台接口；认证后可按用户身份或机器人身份执行，输出支持 JSON、表格、CSV 等格式。

技能介绍

lark-cli 是 Lark/飞书官方命令行工具，由飞书官方团队（GitHub 组织 larksuite）开发，专为人类用户与 AI Agent 两类使用者设计。它把飞书平台的日常操作搬到命令行：用一条命令查今天的日程、发一条消息、建一篇文档，或让 AI Agent 直接以你的身份完成这些操作，无需手动登录网页端。

项目基于 MIT 许可证开源，提供 200+ 命令和 26 个结构化 AI Agent 技能，覆盖即时消息、文档、表格、日历、邮件、任务、会议等核心业务域，适合需要自动化操作 Lark/飞书平台的个人用户和 AI Agent。

适用场景

自动化发送消息、创建日历事件、管理文档和表格
通过 AI Agent 直接操作 Lark/飞书，无需手动登录
批量处理任务、审批、考勤和 OKR 数据
集成到 CI/CD 流水线或脚本中，实现平台操作自动化

核心能力

↔ 左右滑动查看完整表格

领域	能力说明
📅 日历	查看、创建、更新事件，邀请参会人，查找会议室，回复邀请，检查忙闲状态及时间建议
💬 消息	发送/回复消息，创建和管理群聊，查看聊天历史和线程，搜索消息，下载媒体文件
📄 文档	创建、读取、更新和搜索文档，读写媒体和白板
📁 云盘	上传和下载文件，搜索文档及知识库，管理评论
📝 Markdown	创建、获取、更新和覆盖云盘原生 .md 文件
📊 多维表格	创建和管理表格、字段、记录、视图、仪表盘、工作流、表单、角色与权限，数据聚合与分析
📈 电子表格	创建、读取、写入、追加、查找和导出电子表格数据
🖼️ 幻灯片	创建和管理演示文稿，读取内容，添加或删除幻灯片
✅ 任务	创建、查询、更新和完成任务，管理任务列表、子任务、评论和提醒
📚 知识库	创建和管理知识空间、节点和文档
👤 联系人	按姓名/邮箱/手机搜索用户，获取用户信息
📧 邮件	浏览、搜索、阅读邮件，发送、回复、转发，管理草稿，监视新邮件
🎥 会议	搜索会议记录，查询会议纪要产物和录制
🕐 考勤	查询个人考勤打卡记录
✍️ 审批	查询审批任务，审批/拒绝/转交任务，取消和抄送实例
🎯 OKR	查询、创建、更新 OKR，管理目标与关键结果、对齐关系、指标和进度
🔗 应用	创建 Spark/妙达应用，发布 HTML/静态站点，运行云端生成，管理访问权限

内置 26 个结构化 AI Agent 技能，可直接与 AI 工具配合使用，无需额外配置。部分技能包括 lark-shared（应用配置、认证登录、身份切换、权限管理、安全规则，其他技能自动加载）、lark-calendar、lark-im、lark-doc、lark-drive、lark-markdown、lark-sheets、lark-slides、lark-base、lark-task、lark-mail、lark-contact、lark-wiki、lark-event（实时事件订阅 WebSocket）、lark-vc、lark-whiteboard（白板/图表 DSL 渲染）、lark-minutes、lark-openapi-explorer、lark-skill-maker、lark-attendance、lark-approval、lark-okr，以及 lark-workflow-meeting-summary（会议纪要聚合与结构化报告）、lark-workflow-standup-report（议程与待办总结）两个工作流技能。

效果预览

工作方式

lark-cli 提供三层命令体系，满足不同粒度的操作需求：

快捷命令（以 + 开头）：面向人类和 AI，自带智能默认值，输出表格，支持预览（dry-run）。
API 命令：基于 Lark 开放平台 OAPI 元数据自动生成，与平台端点一一对应，经过质量验证。
原始 API 调用：直接调用任意 Lark 开放平台接口，覆盖 2500+ API。

用户通过认证后，可以以用户身份或机器人身份执行命令。

输出与调用细节上：默认 JSON 格式，成功时输出到标准输出（exit 0），错误时输出到标准错误（非零退出码）；成功响应携带 ok: true，错误响应携带 ok: false 和 error 对象。分页支持 --page-all 自动翻页、--page-limit 限制页数、--page-delay 设置请求间隔；对可能产生副作用的命令可用 --dry-run 预览请求；用 lark-cli schema 可查看任意 API 方法的参数、请求体、响应结构、支持的身份和权限范围。

你需要提供

Node.js（通过 npm/npx 安装时）
Lark/飞书应用凭证：通过 lark-cli config init 配置（支持交互式引导）
登录授权：通过 lark-cli auth login 完成 OAuth 登录，授权所需权限范围

你会获得

对 Lark/飞书平台各业务域的操作能力，包括读写数据、管理资源、执行自动化流程
支持多种输出格式：JSON（默认）、pretty、table、ndjson、CSV
分页、预览（dry-run）、模式自省等高级功能

使用示例

# 查看今日日程
lark-cli calendar +agenda

# 发送消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "Hello"

# 创建文档
lark-cli docs +create --doc-format markdown --content '周报\n# 进展\n- 完成功能X'

# 以机器人身份发送消息
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"

注意事项：本工具可由 AI Agent 调用，存在模型幻觉、不可预测执行、提示注入等风险；授权后 AI Agent 将以你的身份在被授权范围内操作，可能导致敏感数据泄露或未授权操作，请谨慎使用。工具默认启用多层安全防护，建议不要主动修改默认安全设置。为降低访问令牌泄露风险，CLI 会向官方 Lark/飞书 HTTPS 域名发送最小风险控制信号（操作系统类型、设备硬件型号），此保护默认开启，可通过 lark-cli config risk-control off 关闭。运行时调用 Lark/飞书开放平台 API，使用 API 需遵守相关服务条款和隐私政策。