核心依赖（提前安装）

1. 安装 Node.js（全平台）

首先需要下载并安装 Node.js。

Linux/Ubuntu

# 添加 Node.js 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

Windows (WSL2)

在 WSL2 终端中执行与 Linux 相同的步骤：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

2. 验证安装

安装完成后，验证 Node.js 和 npm 是否安装成功：

node -v  # 示例输出：v24.13.0
npm -v   # 示例输出：11.6.2

安装pnpm

npm install -g pnpm

3. 可选依赖（提升兼容性）

根据操作系统安装 Git：

# Linux
sudo apt install git

# macOS
brew install git

# Windows
# 从官网下载：https://git-scm.com/download/win

4. 安装 pnpm（推荐）

pnpm 是 npm 的替代品，安装速度更快、磁盘占用更小：

npm install -g pnpm

二、3 种安装方式（按需选择）

方式 1：官方一键安装（新手首选，3 分钟搞定）

自动检测系统环境、安装缺失依赖（如 Node.js）、全局部署 OpenClaw 并启动配置向导，全程无需手动干预，适合零基础用户。

（1）macOS/Linux/WSL2

在终端执行以下命令：

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

（2）Windows（PowerShell 管理员权限）

打开「管理员模式 PowerShell」，执行：

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

（3）跳过配置向导（仅安装 CLI，高级用户）

仅安装 CLI 工具，跳过配置向导：

# macOS/Linux/WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

powershell管理员模式下安装WSL2

wsl   --install 
wsl --list --verbose
wsl --install -d ubtuntn-24.04

方式 2：npm 手动安装（适合已安装 Node.js 的用户）

（1）全局安装 OpenClaw

基础安装（适用于所有系统）：

npm install -g openclaw@latest

macOS/Linux 若提示权限不足，请使用 sudo：

sudo npm install -g openclaw@latest

国内用户可切换 npm 镜像以加速下载（可选）：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

若 sharp 依赖安装失败（macOS 常见问题），可尝试以下命令：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

（2）验证安装

openclaw --version  # 输出版本号即成功，示例：v1.8.2