lark-cli

Lark/飞书官方命令行工具，提供200+命令和26个AI Agent技能，覆盖即时消息、文档、表格、日历、邮件、任务、会议等核心业务域。适合需要自动化操作Lark/飞书平台的个人用户和AI Agent。

适用场景

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

核心能力

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

工作方式

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

1. 快捷命令（以 + 开头）：面向人类和AI，自带智能默认值，输出表格，支持预览（dry-run）。
2. API命令：基于Lark开放平台OAPI元数据自动生成，与平台端点一一对应，经过质量验证。
3. 原始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需遵守相关服务条款和隐私政策。