
以下内容是cc写完用飞书CLI制作完成
飞书命令行工具完整使用手册

一、快速开始
1.1 安装
npm install -g @larksuite/clinpx skills add https://github.com/larksuite/cli -y -g
1.2 初始化配置
lark-cli config init --new
打开生成的链接,在飞书开发者后台完成应用配置。
1.3 用户登录
lark-cli auth login --domain calendar --domain im --domain docs
1.4 身份切换
| 身份 | 标识 | 适用场景 |
| --- | --- | --- |
| 用户身份 | --as user | 访问用户个人资源(日历、云空间等) |
| 应用身份 | --as bot | 应用级操作,访问 bot 自己的资源 |
二、19 个 Skills 功能模块
2.1 lark-doc — 云文档管理
核心功能:创建和编辑飞书文档、搜索云空间、插入媒体文件
| 命令 | 说明 |
| --- | --- |
| docs +create | 创建新文档 |
| docs +fetch | 获取文档内容 |
| docs +update | 更新文档内容 |
| docs +search | 搜索云空间文档/表格 |
| docs +media-insert | 插入图片或文件 |
| docs +media-download | 下载文档媒体 |
示例:
# 创建文档lark-cli docs +create --title "我的文档" --as user
2.2 lark-sheets — 电子表格
核心功能:创建和操作电子表格,读写数据,导出文件
| 命令 | 说明 |
| --- | --- |
| sheets +create | 创建表格 |
| sheets +info | 获取表格信息 |
| sheets +read | 读取单元格 |
| sheets +write | 写入单元格 |
| sheets +append | 追加行数据 |
| sheets +find | 查找内容 |
| sheets +export | 导出表格 |
示例:
# 读取表格数据lark-cli sheets +read --spreadsheet <token> --range "A1:D10" --as user
2.3 lark-base — 多维表格
核心功能:管理多维表格,数据分析,工作流配置
| 命令 | 说明 |
| --- | --- |
| base +table-list | 列出数据表 |
| base +field-list | 列出字段 |
| base +record-list | 列出记录 |
| base +record-upsert | 创建/更新记录 |
| base +data-query | 聚合分析查询 |
| base +workflow-create | 创建工作流 |
示例:
2.4 lark-im — 即时通讯
核心功能:发送消息,管理群聊,搜索聊天记录
| 命令 | 说明 |
| --- | --- |
| im +messages-send | 发送消息 |
| im +messages-reply | 回复消息 |
| im +messages-search | 搜索消息 |
| im +chat-create | 创建群聊 |
| im +chat-search | 搜索群聊 |
示例:
# 发送文本消息lark-cli im +messages-send --chat-id <id> --text "Hello!" --as bot
2.5 lark-calendar — 日历管理
核心功能:日程管理,忙闲查询,智能推荐会议时间
| 命令 | 说明 |
| --- | --- |
| calendar +agenda | 查看日程安排 |
| calendar +create | 创建日程 |
| calendar +freebusy | 查询忙闲状态 |
| calendar +suggestion | 推荐空闲时段 |
示例:
2.6 lark-task — 任务管理
核心功能:创建任务,管理清单,分配成员
| 命令 | 说明 |
| --- | --- |
| | |
| | |
| | |
| | |
| | |
| | |
示例:
# 获取我的任务lark-cli task +get-my-tasks --as user
2.7 lark-mail — 邮箱管理
核心功能:收发邮件,管理草稿,处理附件
| 命令 | 说明 |
| --- | --- |
| mail +triage | 查看收件箱摘要 |
| mail +message | 读取邮件 |
| mail +send | 发送邮件/保存草稿 |
| mail +reply | 回复邮件 |
| mail +forward | 转发邮件 |
示例:
# 查看收件箱lark-cli mail +triage --as user
2.8 lark-drive — 云空间
核心功能:文件上传下载,权限管理,评论
| 命令 | 说明 |
| --- | --- |
| drive +upload | 上传文件 |
| drive +download | 下载文件 |
| drive +add-comment | 添加评论 |
2.9 lark-contact — 通讯录
核心功能:搜索用户,获取组织架构
| 命令 | 说明 |
| --- | --- |
| contact +search-user | 搜索用户 |
| contact +get-user | 获取用户信息 |
示例:
# 获取当前用户信息lark-cli contact +get-user --as user# 搜索用户lark-cli contact +search-user --query "张三" --as user
2.10 lark-vc — 视频会议
核心功能:搜索会议记录,获取会议纪要
| 命令 | 说明 |
| --- | --- |
| vc +search | 搜索历史会议 |
| vc +notes | 获取会议纪要 |
2.11 lark-minutes — 妙记
核心功能:获取妙记信息(标题、封面、时长)
2.12 lark-wiki — 知识库
核心功能:管理知识空间和文档节点
lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'
2.13 lark-whiteboard — 画板
核心功能:绘制架构图、流程图、思维导图等
支持图表类型:
- •架构图、组织架构图
- •流程图、时序图
- •思维导图、鱼骨图
- •柱状图、折线图、漏斗图
三、测试案例汇总
案例 1:查看今日日程
结果:成功获取今日日程列表,包含会议主题、时间、参会人等信息。
案例 2:获取个人信息
lark-cli contact +get-user --as user
结果:
案例 3:获取我的任务
lark-cli task +get-my-tasks --as user
结果:成功获取 26 条待办任务,包含任务标题、创建时间、截止日期等。
四、权限说明
使用不同功能需要相应的 scope 权限:
| 模块 | 常用权限 |
| --- | --- |
| 日历 | calendar:calendar:read, calendar:calendar.event:create |
| 消息 | im:message:readonly, im:chat:read |
| 文档 | docs:document:readonly, docx:document:create |
| 任务 | task:task:read, task:task:write |
| 通讯录 | contact:user.base:readonly |
五、常见问题
Q: 遇到权限不足怎么办?
Q: 如何切换 user/bot 身份?
# 使用用户身份lark-cli calendar +agenda --as user# 使用应用身份lark-cli im +messages-send --as bot
Q: Wiki 链接如何处理?
Wiki 链接需要先查询真实 token:
更多详情请参考:https://github.com/larksuite/cli
# 数据聚合分析lark-cli base +data-query --base-token <token> --table-id <id> --json {...}
# 查看今日日程lark-cli calendar +agenda --as user# 创建会议lark-cli calendar +create --summary "项目评审" --start "2026-03-30T10:00:00+08:00" --end "2026-03-30T11:00:00+08:00" --as user
lark-cli minutes minutes get --params '{"minute_token": "<token>"}'
lark-cli calendar +agenda --as user
{ "name": "🌈AJ", "open_id": "ou_cdac69cfe18cff7cd7122464207908b9"}
# 增量授权lark-cli auth login --scope "calendar:calendar:read"
lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}'