larksuite/cli 怎么安装？飞书 CLI 与 AI Agent 使用教程

安装 larksuite/cli 前，先确认机器上有 Node.js、npm 和 npx。npm 包声明支持 Node.js 16 以上；如果从源码构建，还需要 Go 1.23 以上和 Python 3。先跑预检，避免安装完成后才发现命令不在 PATH。

先检查环境，再选安装方式

node -v
npm -v
npx --version

推荐方式是一条安装向导命令，它会全局安装 CLI，并同步 Agent Skills：

npx @larksuite/cli@latest install

需要审查源码时，改用 HTTPS 克隆：

git clone https://github.com/larksuite/cli.git
cd cli
make install
npx skills add larksuite/cli -y -g

CLI 位于 npm 全局前缀，Skills 会注册到检测到的 AI 工具；可用 npx skills ls -g 查看实际目录。首次安装不用新建 .env，App ID 与 App Secret 由配置流程写入本机配置或密钥存储。

安装目标和更新路径

npm 向导会根据 macOS、Linux 或 Windows 以及 CPU 架构下载对应的官方 release 二进制，并用包内校验值验证文件。全局安装适合日常使用；源码方式主要用于审查实现和参与贡献。后续升级不要只覆盖二进制，直接运行 lark-cli update，它会同时检查 CLI 与 Skills，减少两者版本错位。企业网络若无法直连官方仓库，可先请管理员放行 GitHub 与 npm 域名；不要关闭校验，也不要从不明网盘获取二进制文件。

完成应用配置与用户授权

lark-cli config init --new
lark-cli auth login --recommend
lark-cli auth status

前两条命令会给出浏览器链接，需要本人确认。Agent 环境不便持续等待时，可用 auth login --no-wait --json 取得链接和 device code，授权后再续接。配置完成后重启 Codex、Cursor 等 AI 工具，让新 Skills 被重新发现。

安装成功看这四项

• lark-cli --version 能返回版本号。
• auth status 显示可用身份与 scope。
• calendar +agenda --as user 能读取日程。
• npx skills ls -g 能看到 lark- Skills。

两个常见故障

提示“command not found”时，用 npm root -g 检查全局目录是否进入 PATH；Skills 已装但 Agent 不响应时，先重启 AI 工具，再用 npx skills ls -g 核对。授权链接过期就重新执行登录，不要复用旧 device code。macOS 上若 Codex 沙箱无法访问系统钥匙串，应在普通 Terminal 中运行一次 lark-cli config keychain-downgrade，不要在沙箱里反复重试。敏感凭证也不要写进命令历史或提交到仓库。