AI摘要：OpenClaw提供三款官方安装器脚本，适配不同场景。介绍了各安装器功能、参数查看方法及运行逻辑，还阐述了安装中自动检测系统、处理权限等问题，以及git依赖说明和常见问题解决办法，强调安装后找不到命令时需检查PATH配置。

OpenClaw 提供三款官方安装器脚本（托管于 openclaw.ai 域名下），适配不同场景需求：
https://openclaw.ai/install.sh：推荐安装器（默认全局 npm 安装，也支持从 GitHub 源码检出安装）
https://openclaw.ai/install-cli.sh：免 root 权限的 CLI 安装器（将程序安装到带独立 Node 环境的前缀目录）
https://openclaw.ai/install.ps1：Windows PowerShell 安装器（默认 npm 安装，可选 git 源码安装）
查看安装器参数 / 执行逻辑
bash
运行

macOS/Linux 查看 install.sh 帮助

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --help
powershell

Windows PowerShell 查看 install.ps1 帮助

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -?
注意：若安装器执行完成，但新终端中无法找到 openclaw 命令，通常是 Node/npm 的 PATH 环境变量配置问题，可参考「安装」章节解决。
install.sh（推荐安装器）
核心功能
自动检测操作系统类型（macOS / Linux / WSL）；
确保系统安装 Node.js 22+ 版本（macOS 自动通过 Homebrew 安装，Linux 自动通过 NodeSource 安装）；
支持两种安装方式：
npm 安装（默认）：执行 npm install -g openclaw@latest
git 安装：克隆并构建源码，同时安装包装脚本；
Linux 系统专属优化：若全局 npm 权限不足，自动将 npm 前缀切换至 ~/.npm-global，避免权限错误；
升级场景处理：升级现有安装时，自动尝试执行 openclaw doctor --non-interactive；
git 安装场景处理：安装 / 更新完成后，自动尝试执行 openclaw doctor --non-interactive；
缓解 sharp 原生安装问题：默认设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1，避免基于系统 libvips 编译。
自定义 sharp 编译行为
若需让 sharp 链接到全局安装的 libvips（或调试相关问题），可手动覆盖环境变量：
bash
运行
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL https://openclaw.ai/install.sh | bash
源码检出目录的智能提示
若在已存在的 OpenClaw 源码检出目录中运行安装器（通过 package.json + pnpm-workspace.yaml 自动检测），脚本会给出两个选项：
更新并使用当前源码检出（git 方式）；
迁移至全局 npm 安装（npm 方式）。
注意：在非交互式环境下（无 TTY 或指定 --no-prompt），必须通过 --install-method git|npm 参数（或设置 OPENCLAW_INSTALL_METHOD 环境变量）指定安装方式，否则脚本会以退出码 2 终止运行。
Git 依赖说明
使用 --install-method git 安装时，必须提前安装 Git（脚本依赖 Git 完成克隆 / 拉取操作）；
npm 安装方式通常无需 Git，但部分环境下（如通过 git URL 拉取包 / 依赖）仍需 Git。为避免全新系统出现 spawn git ENOENT 错误，安装器会自动检查并确保 Git 已安装。
Linux 系统 npm EACCES 错误解决
部分 Linux 环境中（尤其是通过系统包管理器 / NodeSource 安装 Node 后），npm 全局前缀指向 root 所属目录，执行 npm install -g ... 会触发 EACCES/mkdir 权限错误。
install.sh 会自动将 npm 前缀切换至 ~/.npm-global，并将该目录的 bin 路径自动添加到 ~/.bashrc / ~/.zshrc 的 PATH 中（若文件存在），解决权限问题。
install-cli.sh（免 root 权限 CLI 安装器）
该脚本将 openclaw 安装到指定前缀目录（默认：~/.openclaw），同时在该目录下安装独立的 Node 运行时，适用于不想改动系统 Node/npm 环境的场景。
查看帮助
bash
运行
curl -fsSL https://openclaw.ai/install-cli.sh | bash -s -- --help
install.ps1（Windows PowerShell 安装器）
核心功能
确保系统安装 Node.js 22+ 版本（自动通过 winget/Chocolatey/Scoop 安装，或提示手动安装）；
支持两种安装方式：
npm 安装（默认）：执行 npm install -g openclaw@latest
git 安装：克隆并构建源码，同时安装包装脚本；
升级 /git 安装场景处理：自动尝试执行 openclaw doctor --non-interactive。
使用示例
powershell

默认 npm 安装

iwr -useb https://openclaw.ai/install.ps1 | iex

指定 git 安装

iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git

指定 git 安装并自定义克隆目录

iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\openclaw"
环境变量配置
OPENCLAW_INSTALL_METHOD=git|npm：指定安装方式；
OPENCLAW_GIT_DIR=<路径>：自定义 git 克隆目录。
Git 依赖说明
若指定 -InstallMethod git 但系统未安装 Git，安装器会打印 Git for Windows 下载链接（https://git-scm.com/download/win）并终止运行。
Windows 常见问题解决
npm error spawn git / ENOENT：安装 Git for Windows 后重启 PowerShell，重新运行安装器；
“openclaw 不是可识别的命令”：npm 全局 bin 目录未加入 PATH。多数系统默认路径为 %AppData%\npm，也可执行 npm config get prefix 获取前缀目录，将其下的 \bin 路径添加到系统 PATH 后重启 PowerShell。
总结
OpenClaw 提供三款安装器适配不同场景，install.sh 为推荐选项，install-cli.sh 免 root 权限，install.ps1 适配 Windows；
安装器会自动处理 Node 版本、npm 权限、sharp 编译等问题，git 安装需提前部署 Git 环境；
安装后若找不到 openclaw 命令，核心解决思路是检查并修复 npm/Node 的 PATH 环境变量配置。