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

通过命令行或 AI 代理高效管理飞书文档、日历、消息及自动化办公流程。

详细介绍

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需遵守相关服务条款和隐私政策。

试试这样做

• 使用 lark-cli 查看我今天的日程安排。
• 如何使用 lark-cli 发送一条飞书消息？
• 请帮我搜索并读取飞书云文档中的特定内容。

作者：larksuite 开发者 / 职场人 ｜ GitHub Stars 16K ｜ 标签：自动化 知识管理 已认证 开源许可: MIT

来源：colaos.ai ｜ Skill ID：larksuite-cli