{"id":162,"date":"2026-03-21T22:47:20","date_gmt":"2026-03-21T14:47:20","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-installer\/"},"modified":"2026-03-21T23:23:49","modified_gmt":"2026-03-21T15:23:49","slug":"install-installer","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/install-installer\/","title":{"rendered":"\u5b89\u88c5\u5668\u5185\u90e8\u673a\u5236"},"content":{"rendered":"

安装器内部机制<\/h1>\n

OpenClaw 提供三个安装脚本，由 openclaw.ai<\/code> 提供。<\/p>\n\n\n\n\n\n\n\n
脚本<\/th>\n平台<\/th>\n功能<\/th>\n<\/tr>\n<\/thead>\n
install.sh<\/code><\/a><\/td>\nmacOS \/ Linux \/ WSL<\/td>\n如有需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行新手引导。<\/td>\n<\/tr>\n
install-cli.sh<\/code><\/a><\/td>\nmacOS \/ Linux \/ WSL<\/td>\n将 Node + OpenClaw 安装到本地前缀（~\/.openclaw<\/code>）中。无需 root。<\/td>\n<\/tr>\n
install.ps1<\/code><\/a><\/td>\nWindows（PowerShell）<\/td>\n如有需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行新手引导。<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

快速命令<\/h2>\n

bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n curl -fsSL --proto '=https' --tlsv1.2 https:\/\/openclaw.ai\/install.sh | bash<\/code><\/p>\n

```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ncurl -fsSL --proto '=https' --tlsv1.2 https:\/\/openclaw.ai\/install.sh | bash -s -- --help\n```\n<\/code><\/pre>\n<\/p>\n
\n    bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n    curl -fsSL --proto '=https' --tlsv1.2 https:\/\/openclaw.ai\/install-cli.sh | bash<\/code><\/p>\n
```bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\ncurl -fsSL --proto '=https' --tlsv1.2 https:\/\/openclaw.ai\/install-cli.sh | bash -s -- --help\n```\n<\/code><\/pre>\n<\/p>\n
\n    powershell  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
\n    iwr -useb https:\/\/openclaw.ai\/install.ps1 | iex<\/code><\/p>\n
```powershell  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}\n& ([scriptblock]::Create((iwr -useb https:\/\/openclaw.ai\/install.ps1))) -Tag beta -NoOnboard -DryRun\n```\n<\/code><\/pre>\n<\/p>\n
\n  如果安装成功但在新终端中找不到 openclaw<\/code>，请参见 Node.js 故障排除<\/a>。\n<\/p>\n
\n
install.sh<\/h2>\n
\n  推荐用于大多数 macOS\/Linux\/WSL 上的交互式安装。\n<\/p>\n
流程（install.sh）<\/h3>\n
    支持 macOS 和 Linux（包括 WSL）。如果检测到 macOS，则会在缺少 Homebrew 时安装它。\n  <\/p>\n
\n    检查 Node 版本，并在需要时安装 Node 24（macOS 上使用 Homebrew，Linux apt\/dnf\/yum 上使用 NodeSource 设置脚本）。为了兼容性，OpenClaw 仍支持 Node 22 LTS，目前为 22.16+<\/code>。\n  <\/p>\n
\n    如果缺少 Git，则安装它。\n  <\/p>\n
\n    * npm<\/code> 方法（默认）：全局 npm 安装
\n    * git<\/code> 方法：克隆\/更新仓库，使用 pnpm 安装依赖，构建，然后将包装器安装到 ~\/.local\/bin\/openclaw<\/code>\n  <\/p>\n
\n    * 在升级和 git 安装时运行 openclaw doctor --non-interactive<\/code>（尽力而为）
\n    * 在适当情况下尝试运行新手引导（有 TTY、未禁用新手引导，并且 bootstrap\/配置检查通过）
\n    * 默认设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1<\/code><\/p>\n
源码检出检测<\/h3>\n
如果在 OpenClaw 检出目录中运行（package.json<\/code> + pnpm-workspace.yaml<\/code>），脚本会提供：<\/p>\n