OpenClaw安装教程

Windows 端 OpenClaw 安装教程（保姆级）

OpenClaw 是基于 Node.js 的 AI 助手框架，Windows 安装有一键脚本（新手首选）、npm 手动安装、WSL2 稳定部署三种方式，以下是详细步骤。

一、前置准备（所有方式通用）

1. 安装 Node.js（必须）

OpenClaw 依赖 Node.js v22+ LTS 版本：

1. 访问 Node.js 中文官网，下载 Windows 64 位 .msi 安装包（推荐 LTS 22.x/24.x）。
2. 双击安装包，全程默认下一步，务必勾选 Add to PATH 和 Automatically install necessary tools。
3. 安装完成后，重启电脑，打开 PowerShell 验证：

   node --version  # 输出版本号（v22.x+）即成功
   npm --version   # 输出版本号即成功

2. 临时关闭安全软件

安装前关闭杀毒、防火墙、安全卫士，避免拦截脚本 / 依赖下载 

---

 

二、方式一：PowerShell 一键脚本（新手首选，最快）

步骤 1：以管理员身份打开 PowerShell

1. 开始菜单搜索 PowerShell → 右键 → 以管理员身份运行
2. 首次运行需修改执行策略（允许脚本运行）：
   powershell

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 提示时输入 Y 并回车确认

步骤 2：执行一键安装脚本

• 官方脚本（海外网络）：
  powershell

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

• 国内加速脚本（推荐，速度更快）：
  powershell

  iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

步骤 3：等待安装完成

脚本会自动：检测 Node.js、安装 OpenClaw、配置环境变量、安装依赖，全程 3–8 分钟，不要关闭终端。

步骤 4：验证安装

openclaw --version  # 输出版本号即安装成功

步骤 5：初始化配置（首次必做）

powershell

openclaw onboard --install-daemon

按提示选择模型、设置端口、安装守护进程（开机自启）。

如果过程中有选项选择错误的话，可以点击ESC直接退出后再重新进行选择

选择选项可以用上下左右键再按下enter键选择答案，也可以直接用键盘打首字母进行选择

✅ 直接选择 Local gateway (this machine)

• 这是个人使用 OpenClaw 的标准方式，会在你当前的电脑上完整部署并启动网关服务。
• 操作：保持当前光标位置，按回车键确认即可。

 选择盘符的时候我这边选了 D盘

选择模型

 

 

 

 

 

---

 

三、方式二：npm 手动安装（脚本失败时用）

步骤 1：配置 npm 国内镜像（加速）

npm config set registry https://registry.npmmirror.com

步骤 2：全局安装 OpenClaw

# 官方版
npm install -g openclaw@latest
# 国内版（openclaw-cn，适配国内网络）
npm install -g openclaw-cn@latest

步骤 3：初始化与验证

# 初始化（官方版）
openclaw onboard --install-daemon
# 国内版初始化
openclaw-cn onboard --install-daemon

# 验证版本
openclaw --version
# 启动网关（默认端口 18789）
openclaw gateway --port 18789

浏览器访问 http://localhost:18789 打开管理面板。

 

---

 

四、方式三：WSL2 部署（官方推荐，最稳定）

 

原生 Windows 兼容性一般，WSL2（Linux 子系统） 是官方推荐方案，长期使用更稳定。

 

步骤 1：安装 WSL2

1. 管理员 PowerShell 执行：

   wsl --install

2. 重启电脑，自动安装 Ubuntu，按提示设置用户名、密码。

步骤 2：WSL2 内安装依赖

打开 Ubuntu 终端，执行：

# 更新系统
sudo apt update && sudo apt upgrade -y
# 安装 Node.js v22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证
node --version
npm --version

步骤 3：安装 OpenClaw

# 国内镜像
npm config set registry https://registry.npmmirror.com
# 全局安装
npm install -g openclaw@latest
# 初始化
openclaw onboard --install-daemon
# 启动网关
openclaw gateway --port 18789

 

---

 

五、常见问题与解决

1. 脚本执行报错：确认以管理员运行 PowerShell，执行 Set-ExecutionPolicy RemoteSigned，关闭安全软件。
2. node/npm 不是内部命令：重启电脑，或手动将 Node.js 安装目录添加到系统 PATH。
3. 安装速度慢：使用国内脚本 / 镜像，或切换网络。
4. 启动失败：检查 Node.js 版本（必须 ≥22），重新执行 openclaw onboard 初始化。

 

---

 

六、启动与使用

• 启动网关：openclaw gateway --port 18789
• 访问面板：浏览器打开 http://localhost:18789
• 查看帮助：openclaw --help