OpenClaw 安装指南：从依赖准备到三种安装方式

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

bash 复制代码

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

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

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

bash 复制代码

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

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

bash 复制代码

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

安装pnpm

c 复制代码

npm install -g pnpm

根据操作系统安装 Git：

bash 复制代码

# Linux
sudo apt install git

# macOS
brew install git

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

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

bash 复制代码

npm install -g pnpm

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

在终端执行以下命令：

bash 复制代码

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

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

powershell 复制代码

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

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

bash 复制代码

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

powershell管理员模式下安装WSL2

cpp 复制代码

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

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

bash 复制代码

npm install -g openclaw@latest

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

bash 复制代码

sudo npm install -g openclaw@latest

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

bash 复制代码

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

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

bash 复制代码

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

bash 复制代码

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