openclaw安装教程
安装前准备工作
要想顺利开始，咱们先得把准备工作做到位。放心，整个过程不涉及任何代码，你只需要会复制粘贴命令就足够了。
首先，需要一台电脑，系统不限，Mac、Windows 或者 Linux 都行。其中，Mac 的体验通常最顺畅；如果是 Windows 系统，强烈推荐使用 WSL2 环境，后续会详细说明。
其次，网络环境得稳定，确保能正常访问 Github 等资源。
最后，预留出大约 15 到 30 分钟的空闲时间。只要这些条件满足，你就可以开始了。
这里有个细节需要注意：Mac 和 Windows 的初始安装路径略有不同，但一旦进入配置环节，步骤就完全一致了。
Mac 用户安装流程
对于 Mac 用户来说，你有两种选择：让脚本自动搞定一切，或者自己动手逐步安装。
自动安装（推荐）
官方提供的一键安装脚本是最高效的选择。它会自动检测你的系统环境，并安装所需的 Node.js（要求版本22及以上）及其他依赖。
第一步：打开终端
按下 Command + 空格键，搜索并打开“终端”应用。
第二步：执行安装脚本
直接复制下面这行命令，粘贴到终端窗口里，然后按回车：
curl -fsSL https://openclaw.ai/install.sh | bash
接下来，脚本就会自动处理所有事情，包括安装或检查 Homebrew 等环境。整个过程大概需要 3 到 10 分钟。期间如果提示输入开机密码，屏幕上虽然不会显示字符，但你正常输入后按回车即可。安装完成后，配置向导会自动启动，带你进入下一步。
手动安装
如果你更喜欢自己掌控每一步，或者脚本安装遇到了问题，可以按照这个流程来。
第一步：安装 Node.js
Node.js 官网列出了各种安装方式。考虑到后续使用 OpenClaw 很可能用到 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 芯片的 Mac，安装完 Homebrew 后，可能还需要按照脚本的提示手动添加一下 PATH：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"
第二步：安装 OpenClaw
在终端输入下面的命令，全局安装 OpenClaw 命令行工具：
npm install -g openclaw@latest
安装完成后，输入以下命令验证是否成功：
openclaw --version
终端能返回版本号，就意味着一切就绪了。
Windows 用户安装流程
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”，点击打开它，然后按照提示完成用户名和密码的设置。
可能有人会问，什么是 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 系统下建议安装方式
最后，给 Windows 用户一个清晰的决策路径：
1. 优先尝试 WSL2 一键安装方式，这是目前成功率最高的选择。
2. 如果你实在不想安装 WSL，再尝试 PowerShell 的一键脚本。
3. 如果两种一键方式都失败了，那就采用对应系统的手动安装方式，并把错误日志贴到社区求助，大家会很乐意帮你解决。