飞书 CLI (lark-cli)

飞书官方开源的命令行工具，为 AI Agent 提供连接飞书业务系统的标准化执行入口。安装后 Agent 可以直接读消息、查日历、写文档、建多维表格、发邮件，把任务真正落到飞书里完成。

官方 GitHub: https://github.com/larksuite/cli （7.3k+ Stars） 官方介绍: https://www.feishu.cn/content/article/7623291503305083853 npm: https://www.npmjs.com/package/@larksuite/cli

安装

# 第一步：安装 lark-cli
npm install -g @larksuite/cli

# 第二步：安装相关 Skills
npx skills add https://github.com/larksuite/cli -y -g

# 第三步：初始化应用配置（默认创建新应用，也可选已有应用）
lark-cli config init --new

安装完成后需重启 AI Agent 工具，确保 skills 完整加载。

认证

飞书 CLI 支持两种工作模式：

应用身份（Bot）

不需要用户授权即可使用。AI 可执行发消息、创建文档等操作，但无法访问用户个人数据（如日程、私信、收件箱）。只需在飞书开发者后台开通对应 scope。

用户身份（User）

AI 可以访问用户的个人日历、消息、文档，并以用户名义执行操作。需要完成一次用户授权：

lark-cli auth login

执行后打开链接在飞书中确认即可。后续 AI 在需要访问个人数据时也会自动发起授权提示。

身份选择原则

• Bot 看不到用户资源（日历、云空间文档、邮箱等）
• Bot 无法代表用户操作
• 涉及个人数据的操作必须使用 User 身份

权限不足处理

• Bot 身份：将 console_url 提供给用户，去后台开通 scope
• User 身份：

  lark-cli auth login --scope "missing_scope"

核心业务域

业务域	核心能力
消息与群组	搜索消息和群聊、发送消息、回复话题
云文档	创建文档、读取内容、更新正文、评论协作
云空间	上传下载文件、管理权限、处理评论
电子表格	创建表格、读写单元格、批量更新
多维表格	管理数据表、字段、记录、视图、仪表盘、自动化
日历	查询日程、创建会议、查询忙闲、推荐时间
视频会议	搜索会议、获取纪要和逐字稿、关联日程文档
邮箱	搜索、读取、起草、发送、回复、归档邮件
任务	创建任务、更新状态、管理清单和子任务
知识库	查询空间、管理节点和文档层级
通讯录	查询用户、搜索同事、查看部门
搜索	搜索群聊、消息、文档等

典型使用场景

会议待办自动执行

读取妙记逐字稿，提取待办事项，自动帮用户创建文档、发送消息、预约会议。

人与 AI 共创文档

AI 在飞书文档里直接创建初稿，用户用评论提修改意见，AI 读取评论修改正文，持续迭代。也可反过来让 AI 当审稿人用评论提意见。支持 Markdown 与飞书文档双向转换。

跨时区多人智能约会

AI 自动拉群成员、查每个人的日历空闲、考虑所有人时区，推荐合适的会议时间。

日历审计到多维表格仪表盘

拉取日历数据，给会议打标签分类，写入多维表格生成仪表盘，可视化时间分配。

未读邮件智能分类

AI 定期扫描未读邮件，按优先级分类，重要邮件摘要推送到群聊，低优先级自动归档。

验证安装

lark-cli help          # 查看命令总览
lark-cli auth status   # 查看当前登录状态

安全规则

• 禁止输出密钥（appSecret、accessToken）到终端明文
• 写入/删除操作前必须确认用户意图
• 用

  --dry-run

  预览危险请求

更新

lark-cli 命令执行后如检测到新版本，输出中会包含

_notice.update

字段。更新命令：

npm update -g @larksuite/cli && npx skills add larksuite/cli -g -y

支持国际版 Lark

通过

lark-cli config init

并配置国际版 Lark 的应用即可使用。

预置脚本

scripts/setup.py

飞书 lark-cli 安装配置脚本。

python3 scripts/setup.py

scripts/feishu_quick.py

飞书常用操作快捷脚本。

python3 scripts/feishu_quick.py send-msg --receive-id xxx --content "Hello"
python3 scripts/feishu_quick.py list-chats
python3 scripts/feishu_quick.py create-doc --folder-token xxx --title "新文档"
python3 scripts/feishu_quick.py list-events --calendar-id xxx
python3 scripts/feishu_quick.py create-task --summary "待办事项"