Skip to main content
飞书 CLI（lark-cli，npm 包名 @larksuite/cli）是飞书开放平台推出的官方命令行工具。只需一行命令完成安装配置，即可让你的 AI Agent 直接搜索消息、读写文档、管理多维表格、查询日程等，覆盖飞书最核心的业务域。
官网：https://www.feishu.cn/feishu-cli；开源地址：https://github.com/larksuite/cli。

​
支持哪些 AI Agent

飞书 CLI 支持所有主流 AI Agent 工具，安装时会自动完成对应 Agent 的配置接入：
  • Claude Code
  • Codex
  • Cursor
  • Trae
  • GitHub Copilot
  • Windsurf

​
安装

准备 Node.js 环境

安装命令通过 npx 执行，需要本机已安装 Node.js（npm 自带 npx）。

一行命令安装

复制以下命令到终端运行：

按提示完成授权

安装过程中按终端提示完成飞书账号授权。授权完成后，CLI 会同时持有机器人（Bot）与用户（User）身份，按调用场景自动选择。

重启 AI Agent

配置完成后重启你的 AI Agent，即可开始使用。可在终端验证安装：

​
核心能力

CLI 按业务域组织命令，覆盖飞书个人与企业场景，并持续快速迭代： 此外还有审批（approval）、考勤（attendance）、OKR（okr）、思维笔记（mindnotes）、画板（whiteboard）等更多域，可通过 lark-cli --help 查看完整列表。

​
常用命令

Agent 驱动 CLI 时遵循以下优先级（同样适合人工使用）：
实用旗标：
  • --jq <表达式>：过滤 JSON 输出，只取需要的字段
  • --dry-run：预演请求，不真正执行
  • 每条命令的 --help 会标注风险等级：read / write / high-risk-write，高危写操作需要追加 --yes 确认

​
示例：把飞书文档读成 Markdown

本仓库的飞书导入 Skill（.kimi/skills/feishu-to-nec-mdx）就是基于上述命令把飞书 Wiki 内容批量转换为本站文档的，详见仓库 AGENTS.md。

​
常见问题

可以。企业管理员可在飞书管理后台管理应用的可用范围；CLI 调用开放平台接口所需的 API 权限（scope）在开发者后台按应用粒度申请与审批，遵循最小权限原则即可。
安装完成后需要重启终端和 AI Agent，使新配置的环境变量与 PATH 生效。若仍提示找不到 lark-cli，请确认 npm 全局 bin 目录已加入 PATH。
授权码有时效限制，重新执行安装/授权命令，在提示后尽快完成浏览器授权即可。
说明该接口对应的权限 scope 未开通或未随版本发布。到飞书开发者后台为应用添加对应权限、创建并发布新版本后重试；可先用 lark-cli schema <service.resource.method> 查看方法所需的权限范围。
CLI 所有命令均输出结构化 JSON，配合 --jq 过滤字段、--dry-run 预演请求，可直接被脚本与 AI Agent 工作流消费；高危写操作需 --yes 显式确认，适合在自动化流程中做安全卡点。
两者都是连接 AI 与飞书的官方方案，定位不同：飞书 CLI 以命令行方式让任意主流 AI Agent 调用飞书能力；OpenClaw 飞书官方插件则面向 OpenClaw 助手场景做集成。按你实际使用的 Agent 选择其一即可。
支持。CLI 同时面向飞书与 Lark（国际版），授权配置中的 brand 字段标识当前品牌（feishu / lark）。可通过 lark-cli auth status 查看当前配置。

​
相关资源