安装前准备工作
一台普通电脑，Mac、Windows 或 Linux 均可，Mac 体验最顺畅，Windows 推荐 WSL2。
一个稳定的网络环境，能够正常访问 Github。
大约 15-30 分钟时间。
完全不需要写代码，也不需要懂编程，所有操作都是复制粘贴命令在终端工具中执行。
需要注意的是：Mac 和 Windows 安装流程略有不同，但配置环节完全一致。
Mac 用户安装流程
自动安装（推荐）
官方推荐使用一键安装脚本，它会自动检测并安装 Node.js（要求版本 22 及以上）和必要依赖。
第一步：打开终端
按 Command + 空格，搜索并打开 macOS 终端。
第二步：执行安装脚本
直接复制下面这行命令，按回车执行：
curl -fsSL https://openclaw.ai/install.sh | bash   
脚本会自动处理 Node.js、Homebrew（如果缺失）等环境，整个过程 3-10 分钟。
中间可能需要输入开机密码，屏幕不会显示字符，正常盲打即可。
安装完成后，它会自动启动配置向导。
手动安装
第一步：安装 Node.js
Node.js 官网上详细列出了使用不同软件包管理工具的安装方式，考虑到后续在使用 OpenClaw 过程中需要乃至软件包管理工具 Homebrew，推荐直接使用 Homebrew 安装 Node.js。
第1步：下载并安装 Homebrew 
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash 
第2步：下载并安装 Node.js：
brew install node@22
安装完成后，在终端中输入以下命令验证 Node.js 版本：
node -v 
如果终端返回 v22.xx.x 或者更高版本号就说明成功了。
需要注意的是，Apple Silicon 机器安装完 Homebrew 后，可能需要手动加 PATH（脚本会提示）：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)" 
第二步：安装 OpenClaw
在终端输入下命令，全局安装 OpenClaw CLI：
npm install -g openclaw@latest 
安装完成后，在终端输入以下命令验证是否安装成功：
openclaw --version 
终端返回版本号说明安装成功。
Windows 用户安装流程
方式一：PowerShell 原生安装
一键脚本方式（推荐）
官方提供了专属 PowerShell 一键脚本，比手动配置 WSL 更简便（仍建议启用 WSL2 以获得最佳兼容性）。
第一步：以管理员身份打开 PowerShell
按 Win 键搜索 PowerShell，右键选择「以管理员身份运行」。
第二步：解除脚本执行限制
使用以下命令解除权限限制：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 
第三步：执行 Windows 安装脚本
输入下面命令并回车：
iwr -useb https://openclaw.ai/install.ps1 | iex   
这个脚本会自动安装 Node.js 和 OpenClaw。
手动安装方式（更可控，适合公司电脑/不想让脚本自动装 Node）
第一步：管理员 PowerShell 解除限制（同上）
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 
第二步：安装 Node.js 22+（三种推荐方式选一种）
1、最推荐：用 winget（Windows 11 自带）
在 PowerShell 中运行以下命令：
winget install OpenJS.NodeJS --version 22 
或安装最新稳定版本：
winget install OpenJS.NodeJS.LTS
2、官网下载 .msi：nodejs.org/
3、用 nvm-windows 安装：github.com/coreybutler/nvm-windows
第三步：全局安装 OpenClaw
PowerShell 中运行以下命令：
npm install -g openclaw@latest 
如果提示权限问题，可尝试：
npm install -g openclaw@latest --unsafe-perm 
方式二：WSL2 + Ubuntu（目前最稳定、最推荐）
一键脚本方式（强烈推荐）
第一步：安装 WSL
在 PowerShell 里输入下面这行命令，按回车：
wsl --install  
系统会自动下载和安装 WSL2 和 Ubuntu（一个 Linux 系统），需要几分钟到十几分钟。
安装完成后需要重启电脑。
重启后可能自动弹出 Ubuntu 窗口，设置用户名和密码。
用户名需要使用英文，不要使用空格和中文。
密码需要输入两次确认，输入时不会显示字符，盲打后回车。
如果重启后没有自动弹出 Ubuntu 窗口，在开始菜单中搜索 Ubuntu，点击打开它，然后按照提示设置用户名和密码。
什么是 WSL？WSL（Windows Subsystem for Linux）是微软官方提供的一个工具，让你在 Windows 上运行 Linux 系统。 OpenClaw 不能直接在 Windows 上运行，需要通过 WSL 来运行。
第二步：打开 WSL 终端
以后每次操作 OpenClaw，都在这个 WSL 终端里进行（而不是 PowerShell）。
在开始菜单搜索 Ubuntu，点击打开，或者在 PowerShell 里输入 wsl 按回车。
你会看到一个类似 Linux 终端的窗口，显示类似 user@你的电脑名:~$ 的提示符。
怎么在 WSL 终端里粘贴命令？复制命令后，在 WSL 终端窗口里右键点击就是粘贴。 或者用 Ctrl + Shift + V（注意：不是 Ctrl + V）。
第三步：一键安装 OpenClaw
在 WSL 终端里复制粘贴下面这行命令，按回车：
curl -fsSL https://openclaw.ai/install.sh | bash 
脚本会自动安装必要组件并启动向导。
整个过程大概 3-5 分钟，中间不要关掉窗口。
手动安装方式（适合想自己管 Node 版本）
第一步：完成上面 WSL 安装 + 打开 Ubuntu 终端
第二步：更新系统 & 安装基本工具
在 WSL 终端中运行以下命令：
sudo apt update -y && sudo apt upgrade -y sudo apt install -y curl git build-essential 
第三步：安装 Node.js 22+（
1、最推荐：用 nvm（版本切换最方便）
在 WSL 终端里依次输入下面的命令，每行输入后按回车等它执行完再输入下一行：
curl -o- https://raw.githubusercontent.com/nvm- 
sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22
2、或者直接用 Nodesource
在 WSL 终端里依次输入下面的命令：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - 
sudo apt install -y nodejs
依次安装完成后，在 WSL 终端中输出以下命令验证是否安装成功：
node --version  
终端显示 v22.x.x 或更高版本号就说明成功了。
第四步：全局安装 OpenClaw
在 WSL 终端里运行以下命令：
npm install -g openclaw@latest 
Windows 系统下建议安装方式
1.先尝试 WSL2 一键方式（成功率最高）
2.如果你非常不想装 WSL → 再试 PowerShell 一键
3.都失败 → 手动方式 + 贴错误日志到社区求助