用命令行管理飞书文档和日历
larksuite-cli
飞书/Lark 官方命令行工具，专为人类用户与 AI Agent 设计，覆盖文档、日历、消息等核心业务。
试试这样做
使用 lark-cli 查看我今天的日程安排。
如何使用 lark-cli 发送一条飞书消息？
请帮我搜索并读取飞书云文档中的特定内容。
详细介绍
lark-cli
Lark/飞书官方命令行工具，提供200+命令和26个AI Agent技能，覆盖即时消息、文档、表格、日历、邮件、任务、会议等核心业务域。适合需要自动化操作Lark/飞书平台的个人用户和AI Agent。
适用场景
- 自动化发送消息、创建日历事件、管理文档和表格
- 通过AI Agent直接操作Lark/飞书，无需手动登录
- 批量处理任务、审批、考勤和OKR数据
- 集成到CI/CD流水线或脚本中，实现平台操作自动化
核心能力
| 领域 | 能力说明 |
|---|---|
| 📅 日历 | 查看、创建、更新事件，邀请参会人，查找会议室，回复邀请，检查忙闲状态及时间建议 |
| 💬 消息 | 发送/回复消息，创建和管理群聊，查看聊天历史和线程，搜索消息，下载媒体文件 |
| 📄 文档 | 创建、读取、更新和搜索文档，读写媒体和白板 |
| 📁 云盘 | 上传和下载文件，搜索文档及知识库，管理评论 |
| 📝 Markdown | 创建、获取、更新和覆盖云盘原生 .md 文件 |
| 📊 多维表格 | 创建和管理表格、字段、记录、视图、仪表盘、工作流、表单、角色与权限，数据聚合与分析 |
| 📈 电子表格 | 创建、读取、写入、追加、查找和导出电子表格数据 |
| 🖼️ 幻灯片 | 创建和管理演示文稿，读取内容，添加或删除幻灯片 |
| ✅ 任务 | 创建、查询、更新和完成任务，管理任务列表、子任务、评论和提醒 |
| 📚 知识库 | 创建和管理知识空间、节点和文档 |
| 👤 联系人 | 按姓名/邮箱/手机搜索用户，获取用户信息 |
| 📧 邮件 | 浏览、搜索、阅读邮件，发送、回复、转发，管理草稿，监视新邮件 |
| 🎥 会议 | 搜索会议记录，查询会议纪要产物和录制 |
| 🕐 考勤 | 查询个人考勤打卡记录 |
| ✍️ 审批 | 查询审批任务，审批/拒绝/转交任务，取消和抄送实例 |
| 🎯 OKR | 查询、创建、更新OKR，管理目标与关键结果、对齐关系、指标和进度 |
| 🔗 应用 | 创建Spark/妙达应用，发布HTML/静态站点，运行云端生成，管理访问权限 |
工作方式
lark-cli 提供三层命令体系，满足不同粒度的操作需求：
- 快捷命令（以
+开头）：面向人类和AI，自带智能默认值，输出表格，支持预览（dry-run）。 - API命令：基于Lark开放平台OAPI元数据自动生成，与平台端点一一对应，经过质量验证。
- 原始API调用：直接调用任意Lark开放平台接口，覆盖2500+ 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 '<title>周报</title>\n# 进展\n- 完成功能X'
# 以机器人身份发送消息
lark-cli im +messages-send --as bot --chat-id "oc_xxx" --text "Hello"
AI Agent 技能
已内置26个结构化技能，可直接与AI工具配合使用，无需额外配置。以下是部分技能：
| 技能名称 | 说明 |
|---|---|
lark-shared |
应用配置、认证登录、身份切换、权限管理、安全规则（其他技能自动加载） |
lark-calendar |
日历事件（创建/更新）、日程视图、忙闲查询、时间建议、会议室查找、回复邀请 |
lark-im |
发送/回复消息、群聊管理、消息搜索、上传/下载图片和文件、表情反应 |
lark-doc |
创建、读取、更新、搜索文档（基于Markdown） |
lark-drive |
上传、下载文件，管理权限和评论 |
lark-markdown |
创建、获取、更新和覆盖云盘原生Markdown文件 |
lark-sheets |
创建、读取、写入、追加、查找、导出电子表格 |
lark-slides |
创建和管理演示文稿，读取内容，添加或删除幻灯片 |
lark-base |
表格、字段、记录、视图、仪表盘、数据聚合与分析 |
lark-task |
任务、任务列表、子任务、提醒、成员分配 |
lark-mail |
浏览、搜索、阅读邮件，发送、回复、转发，管理草稿，监视新邮件 |
lark-contact |
按姓名/邮箱/手机搜索用户，获取用户信息 |
lark-wiki |
知识空间、节点、文档 |
lark-event |
实时事件订阅（WebSocket），正则路由与Agent友好格式 |
lark-vc |
搜索会议记录，查询会议纪要（摘要、待办、转录） |
lark-whiteboard |
白板/图表DSL渲染 |
lark-minutes |
会议纪要元数据与AI产物（摘要、待办、章节），上传音视频创建纪要，下载媒体 |
lark-openapi-explorer |
从官方文档探索底层API |
lark-skill-maker |
自定义技能创建框架 |
lark-attendance |
查询个人考勤打卡记录 |
lark-approval |
查询审批任务，审批/拒绝/转交任务，取消和抄送实例 |
lark-workflow-meeting-summary |
工作流：会议纪要聚合与结构化报告 |
lark-workflow-standup-report |
工作流：议程与待办总结 |
lark-okr |
查询、创建、更新OKR，管理目标与关键结果、对齐关系、指标 |
注意事项
安全风险：本工具可由AI Agent调用，存在模型幻觉、不可预测执行、提示注入等风险。授权后，AI Agent将以你的身份在被授权范围内操作，可能导致敏感数据泄露或未授权操作。请谨慎使用。
- 默认启用了多层安全防护，建议不要主动修改默认安全设置。
- 建议将集成的飞书机器人作为私人对话助手，不要加入群聊或允许其他用户交互。
- 为降低访问令牌泄露风险，CLI会向官方Lark/飞书HTTPS域名发送最小风险控制信号（操作系统类型、设备硬件型号）。此保护默认开启，可通过
lark-cli config risk-control off关闭。
认证：支持OAuth登录，可交互式选择权限范围，支持以用户或机器人身份执行命令。
输出格式：默认JSON格式，成功时输出到标准输出（exit 0），错误时输出到标准错误（非零退出码）。成功响应携带 ok: true，错误响应携带 ok: false 和 error 对象。
分页：支持 --page-all 自动翻页、--page-limit 限制页数、--page-delay 设置请求间隔。
预览：对可能产生副作用的命令，可使用 --dry-run 预览请求。
模式自省：使用 lark-cli schema 查看任意API方法的参数、请求体、响应结构、支持的身份和权限范围。
本项目基于 MIT 许可证开源。运行时调用Lark/飞书开放平台API，使用API需遵守相关服务条款和隐私政策。