openclaw安装教程

OpenClaw 安装前准备：系统要求与环境配置指南

为确保安装流程顺畅，请在开始前完成以下准备工作。整个过程无需编写代码，仅需复制粘贴命令即可轻松完成。

硬件与系统要求：您需要一台运行 macOS、Windows 或 Linux 操作系统的电脑。其中，macOS 系统兼容性最佳，安装体验最为流畅；Windows 用户强烈建议使用 WSL2 环境以获得完整功能支持。

网络条件：请确保网络连接稳定，能够正常访问 GitHub 等境外开源平台，以便顺利下载安装资源。

时间预估：整个安装配置过程约需15-30分钟。请提前预留充足时间，避免中途中断。

需要注意的是，macOS 与 Windows 系统的初始安装路径存在差异，但进入核心配置阶段后，操作步骤将完全一致。

Mac 用户详细安装教程

Mac 平台提供两种安装方案：一键自动安装（推荐）与手动分步安装，您可根据自身需求选择。

方案一：自动安装（推荐）

官方提供的一键安装脚本可自动检测系统环境，并安装 Node.js（要求 v22 或更高版本）等全部依赖项，极大简化安装流程。

第一步：启动终端
按下 Command + 空格键，聚焦搜索“终端”应用并打开。

第二步：运行安装脚本
复制下方命令，粘贴至终端窗口并按下回车键执行：

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

脚本将自动处理包括 Homebrew 环境在内的所有依赖安装，全程约需3-10分钟。若提示输入开机密码，请正常输入（屏幕不显示字符）后按回车确认。安装成功后，配置向导将自动启动，引导您完成后续设置。

方案二：手动安装

若您偏好手动控制安装流程，或自动脚本遇到问题，可遵循此分步教程。

第一步：安装 Node.js
建议通过 Homebrew 包管理器安装 Node.js，这与后续 OpenClaw 的使用场景最为匹配。

第1步：安装 Homebrew
curl -o- https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh | bash

第2步：安装 Node.js v22
brew install node@22

安装完成后，在终端执行以下命令验证版本：
node -v

若终端返回 v22.x.x 或更高版本信息，则表明安装成功。

注：若您使用 Apple Silicon 芯片的 Mac，安装 Homebrew 后可能需要按提示手动配置 PATH 环境变量：
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile eval "$(/opt/homebrew/bin/brew shellenv)"

第二步：安装 OpenClaw CLI 工具
在终端执行以下命令进行全局安装：
npm install -g openclaw@latest

安装后，通过以下命令校验安装结果：
openclaw --version

若终端成功显示版本号，则表明 OpenClaw 已准备就绪。

Windows 用户安装全攻略

Windows 平台提供多种安装路径，您可根据系统环境与偏好选择最适合的方案。

路径一：PowerShell 原生安装

一键脚本安装（推荐）
官方为 PowerShell 提供了专用一键脚本，简化了安装流程（仍建议启用 WSL2 以获得最佳兼容性）。

第一步：以管理员身份运行 PowerShell
按 Win 键搜索“PowerShell”，右键选择「以管理员身份运行」。

第二步：调整执行策略
输入以下命令以允许脚本运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

第三步：执行 Windows 安装脚本
输入以下命令并回车：
iwr -useb https://openclaw.ai/install.ps1 | iex

该脚本将自动完成 Node.js 与 OpenClaw 的安装。

手动安装（适合企业环境或需精确控制）
第一步：同样以管理员身份运行 PowerShell 并设置执行策略（同上）。

第二步：安装 Node.js v22+（任选其一）
1、推荐使用 winget（Windows 11 内置）：
winget install OpenJS.NodeJS --version 22
或安装最新 LTS 版本：
winget install OpenJS.NodeJS.LTS

2、从官网下载安装包：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 子系统，耗时数分钟至十余分钟。安装完成后请按提示重启计算机。

重启后，系统通常会弹出 Ubuntu 窗口提示创建用户名及密码。请使用英文字符（勿用空格及中文），密码输入时不可见，请正常输入后回车确认。

若未自动弹出，可在开始菜单搜索“Ubuntu”手动启动并完成设置。

WSL（Windows Subsystem for Linux）是微软官方提供的 Linux 兼容层，允许您在 Windows 内直接运行 Linux 环境。由于 OpenClaw 无法在原生 Windows 运行，WSL 是必需的桥梁。

第二步：启动 WSL 终端
此后所有 OpenClaw 相关操作均在此终端内进行（而非 PowerShell）。

可通过开始菜单搜索“Ubuntu”打开，或在 PowerShell 中输入 wsl 回车进入。终端提示符形如 user@hostname:~$。

粘贴技巧：在 WSL 终端窗口中，右键单击即可粘贴；或使用快捷键 Ctrl + Shift + V。

第三步：一键安装 OpenClaw
在 WSL 终端中粘贴以下命令并回车：
curl -fsSL https://openclaw.ai/install.sh | bash

脚本将自动安装全部组件并启动配置向导，全程约3-5分钟，请勿中途关闭窗口。

手动安装（适合需灵活管理 Node 版本的用户）
第一步：完成上述 WSL 安装并打开 Ubuntu 终端。

第二步：更新系统并安装基础工具
依次执行：
sudo apt update -y && sudo apt upgrade -y sudo apt install -y curl git build-essential

第三步：安装 Node.js v22+
方案 A：使用 nvm（便于版本切换）
依次执行每行命令：
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

方案 B：使用 Nodesource 官方源
依次执行：
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

安装完成后，验证 Node.js 版本：
node --version
显示 v22.x.x 或更高版本即表示成功。

第四步：全局安装 OpenClaw
执行：
npm install -g openclaw@latest

Windows 平台安装决策建议

为帮助您快速决策，提供以下清晰路径：

1. 首选方案：采用 WSL2 一键安装，此为成功率最高、兼容性最佳的方案。
2. 备选方案：若不愿安装 WSL，可尝试 PowerShell 原生一键脚本。
3. 排错方案：若上述一键安装均失败，请采用对应系统的手动安装方式，并将错误日志提交至社区论坛，我们将协助您解决问题。