安装概述

安装器内部原理

OpenClaw 提供了三个安装脚本，由 openclaw.ai 提供。

脚本平台功能
install.shmacOS / Linux / WSL如需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行初始化引导。
install-cli.shmacOS / Linux / WSL将 Node + OpenClaw 安装到本地前缀目录（~/.openclaw）。无需 root 权限。
install.ps1Windows (PowerShell)如需要则安装 Node，通过 npm（默认）或 git 安装 OpenClaw，并可运行初始化引导。

快速命令

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

ℹ️ 如果安装成功但在新终端中找不到 openclaw 命令，请参阅 Node.js 故障排除。

install.sh

💡 推荐用于 macOS/Linux/WSL 上的大多数交互式安装。

流程（install.sh）

步骤 1：检测操作系统

支持 macOS 和 Linux（包括 WSL）。如果检测到 macOS，会在缺失时安装 Homebrew。

步骤 2：确保 Node.js 22+

检查 Node 版本，并在需要时安装 Node 22（在 macOS 上使用 Homebrew，在 Linux 上使用 apt/dnf/yum 的 NodeSource 安装脚本）。

步骤 3：确保 Git 已安装

如果缺失则安装 Git。

步骤 4：安装 OpenClaw

  • npm 方法（默认）：全局 npm 安装
  • git 方法：克隆/更新仓库，使用 pnpm 安装依赖，构建，然后在 ~/.local/bin/openclaw 安装包装器

步骤 5：安装后任务

  • 在升级和 git 安装时运行 openclaw doctor --non-interactive（尽力而为）
  • 在适当时尝试运行初始化引导（TTY 可用、未禁用引导且引导/配置检查通过）
  • 默认设置 SHARP_IGNORE_GLOBAL_LIBVIPS=1

源码检出检测

如果在 OpenClaw 检出目录内运行（存在 package.json + pnpm-workspace.yaml），脚本会提供选项：

  • 使用检出目录（git），或
  • 使用全局安装（npm）

如果没有可用的 TTY 且未设置安装方法，则默认使用 npm 并发出警告。脚本会以退出码 2 退出，表示选择了无效的安装方法或提供了无效的 --install-method 值。

示例（install.sh）

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

install-cli.sh

ℹ️ 专为希望将所有内容安装在本地前缀目录（默认 ~/.openclaw）且不依赖系统 Node 的环境设计。

流程（install-cli.sh）

步骤 1：安装本地 Node 运行时

下载 Node 压缩包（默认 22.22.0）到 <prefix>/tools/node-v<version> 并验证 SHA-256。

步骤 2：确保 Git 已安装

如果 Git 缺失，尝试在 Linux 上通过 apt/dnf/yum 或在 macOS 上通过 Homebrew 安装。

步骤 3：在前缀目录下安装 OpenClaw

使用 --prefix <prefix> 通过 npm 安装，然后将包装器写入 <prefix>/bin/openclaw。

示例（install-cli.sh）

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

install.ps1

流程（install.ps1）

步骤 1：确保 PowerShell + Windows 环境

需要 PowerShell 5+。

步骤 2：确保 Node.js 22+

如果缺失，尝试通过 winget、然后 Chocolatey、最后 Scoop 安装。

步骤 3：安装 OpenClaw

  • npm 方法（默认）：使用指定的 -Tag 进行全局 npm 安装
  • git 方法：克隆/更新仓库，使用 pnpm 安装/构建，并在 %USERPROFILE%\.local\bin\openclaw.cmd 安装包装器

步骤 4：安装后任务

在可能的情况下将所需的 bin 目录添加到用户 PATH，然后在升级和 git 安装时运行 openclaw doctor --non-interactive（尽力而为）。

示例（install.ps1）

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

ℹ️ 如果使用 -InstallMethod git 但 Git 缺失，脚本将退出并打印 Git for Windows 的链接。

CI 与自动化

使用非交互式标志/环境变量以实现可预测的运行。

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

故障排除

安装Docker