AI摘要：OpenClaw安装指南：优先用官方安装器，不同系统有对应脚本。介绍了快速安装、手动全局安装、从源代码安装等方式及特殊场景处理。安装后可通过相关命令验证与操作，还说明了故障排除方法，如解决PATH问题。

OpenClaw 安装指南：
除非有特殊需求，否则建议优先使用官方安装器完成部署 —— 它会自动配置 CLI 工具并引导你完成新手设置流程。
快速安装（推荐方式）
macOS/Linux 系统
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
Windows 系统（PowerShell）
powershell
iwr -useb https://openclaw.ai/install.ps1 | iex
后续操作（若跳过了新手引导）
bash
运行
openclaw onboard --install-daemon
系统要求
Node.js 版本 ≥ 22
操作系统：macOS、Linux，或通过 WSL2 运行的 Windows
pnpm 仅在从源代码构建时需要安装
安装方式选择
1）安装器脚本（推荐）
通过安装器可一键完成 openclaw 的 npm 全局安装，并自动运行新手引导：
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash
安装器常用参数
查看所有可用参数：
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
（参数详情可参考「安装器内部原理」文档）
非交互式安装（跳过新手引导）：
bash
运行
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
2）手动全局安装
若已自行安装 Node.js，可直接通过包管理器全局安装：
npm 安装
bash
运行
npm install -g openclaw@latest
特殊场景处理：
若你已全局安装 libvips（如 macOS 下通过 Homebrew 安装）导致 sharp 安装失败，可强制使用预构建二进制文件：
bash
运行
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
若出现 sharp: Please add node-gyp to your dependencies 报错：
方案 1：安装构建工具（macOS：Xcode CLT + npm install -g node-gyp）
方案 2：使用上述 SHARP_IGNORE_GLOBAL_LIBVIPS=1 跳过原生构建
pnpm 安装
bash
运行
pnpm add -g openclaw@latest
注意：pnpm 需要显式批准含构建脚本的包。若首次安装出现「Ignored build scripts」警告，需先执行：
bash
运行
pnpm approve-builds -g # 批准 openclaw、node-llama-cpp、sharp 等包
pnpm add -g openclaw@latest # 重新运行以执行 postinstall 脚本
安装后操作
bash
运行
openclaw onboard --install-daemon
3）从源代码安装（贡献者 / 开发者适用）
bash
运行

克隆仓库

git clone https://github.com/openclaw/openclaw.git
cd openclaw

安装依赖并构建

pnpm install
pnpm ui:build # 首次运行会自动安装 UI 依赖
pnpm build

完成初始化

openclaw onboard --install-daemon
提示：若未全局安装 openclaw，需通过 pnpm openclaw ... 执行仓库内的 CLI 命令。
4）其他安装选项
Docker 部署：参考「Docker 安装文档」
Nix 部署：参考「Nix 安装文档」
Ansible 部署：参考「Ansible 安装文档」
Bun 部署（仅支持 CLI）：参考「Bun 安装文档」
安装后验证与常用操作
bash
运行

运行新手引导（若未自动执行）

openclaw onboard --install-daemon

快速健康检查

openclaw doctor

检查网关状态与健康度

openclaw status
openclaw health

打开管理仪表板

openclaw dashboard
安装器核心参数说明
安装器支持两种核心安装方式，可通过参数指定：
npm 安装（默认）：底层执行 npm install -g openclaw@latest
git 安装：从 GitHub 克隆源码并构建运行
常用 CLI 标志
bash
运行

显式指定 npm 安装

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

指定 git 源码安装

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git
高频使用参数
表格
参数 说明
--install-method npm|git 指定安装方式（npm / 源码）
--git-dir 指定 git 克隆目录（默认：~/openclaw）
--no-git-update 使用现有源码时跳过 git pull
--no-prompt 禁用交互提示（CI / 自动化场景必需）
--dry-run 仅打印执行计划，不实际修改系统
--no-onboard 跳过新手引导流程
环境变量（自动化场景适用）
可通过环境变量替代上述 CLI 参数，便于自动化部署：
OPENCLAW_INSTALL_METHOD=git|npm：指定安装方式
OPENCLAW_GIT_DIR=<路径>：指定 git 克隆目录
OPENCLAW_GIT_UPDATE=0|1：是否更新 git 源码（0 = 跳过，1 = 更新）
OPENCLAW_NO_PROMPT=1：禁用交互提示
OPENCLAW_DRY_RUN=1：仅模拟执行
OPENCLAW_NO_ONBOARD=1：跳过新手引导
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1：是否忽略系统 libvips（默认 1，避免 sharp 原生构建）
故障排除：找不到 openclaw 命令（PATH 问题）
快速诊断
执行以下命令检查环境：
bash
运行
node -v # 检查 Node 版本
npm -v # 检查 npm 版本
npm prefix -g # 查看 npm 全局安装目录
echo "$PATH" # 查看系统 PATH 环境变量
问题原因
若 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）未出现在 echo "$PATH" 的输出中，说明系统无法找到全局 npm 安装的二进制文件（包括 openclaw）。
修复方法
将 npm 全局目录添加到 shell 启动文件：
bash
运行

macOS/Linux（zsh：~/.zshrc，bash：~/.bashrc）

export PATH="$(npm prefix -g)/bin:$PATH"
Windows 系统：将 npm prefix -g 输出的路径手动添加到系统环境变量 PATH 中。
生效配置：
打开新终端窗口
或在当前终端执行：zsh 运行 rehash，bash 运行 hash -r

总结
OpenClaw 推荐用官方安装器部署，不同系统对应不同脚本，安装后可通过 openclaw doctor 验证环境；
支持 npm/pnpm 全局安装、源码安装等多种方式，sharp 安装失败可通过环境变量跳过原生构建；
若出现「找不到 openclaw 命令」，核心是检查 npm 全局目录是否加入系统 PATH，添加后重启终端即可。