Windows 安装指南

OpenClaw 在 Windows 上通过 WSL2 运行，也支持 PowerShell 原生安装。

方式一：WSL2 安装（推荐）

WSL2 提供完整的 Linux 环境，兼容性最好。

1. 安装 WSL2

以管理员身份打开 PowerShell：

# 一键安装 WSL2 + Ubuntu
wsl --install

# 安装完成后重启电脑

重启后会自动打开 Ubuntu 终端，设置用户名和密码。

已有 WSL1？

升级到 WSL2：wsl --set-version Ubuntu 2

2. 安装 Node.js 22+

在 WSL2 终端中：

# 安装 nvm（Node 版本管理器）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# 重新加载 shell
source ~/.bashrc

# 安装 Node.js 22
nvm install 22
nvm use 22

# 验证
node -v  # 应显示 v22.x.x

3. 安装 OpenClaw

# NPM 全局安装
npm install -g openclaw@latest

# 运行引导向导
openclaw onboard --install-daemon

4. 配置 API Key

# 编辑环境变量
nano ~/.openclaw/.env

写入：

ANTHROPIC_API_KEY=sk-ant-xxx
# 或
OPENAI_API_KEY=sk-xxx

5. 启动

openclaw gateway start
openclaw doctor  # 健康检查

方式二：PowerShell 原生安装

# 一键安装脚本
iwr -useb https://openclaw.ai/install.ps1 | iex

注意

原生 Windows 安装功能受限：

• 不支持 iMessage 集成
• 部分 Skills 依赖 Linux 工具链
• Docker 沙箱需要 Docker Desktop 推荐优先使用 WSL2 方式。

常见问题

WSL2 安装失败："虚拟化未启用"

需要在 BIOS 中开启虚拟化：

1. 重启电脑，进入 BIOS（通常按 F2/Del/F12）
2. 找到 Intel VT-x 或 AMD-V，设为 Enabled
3. 保存退出

openclaw 命令找不到

# 检查 npm 全局路径
npm config get prefix

# 添加到 PATH（写入 ~/.bashrc）
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

WSL2 网络问题（无法访问外网）

# 检查 DNS
cat /etc/resolv.conf

# 如果 DNS 不对，手动设置
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'

Node.js 版本不够

# 如果用 apt 安装的 Node.js 版本太低
sudo apt remove nodejs
# 用 nvm 重新安装
nvm install 22

Gateway 端口被占用

# 检查 18789 端口
lsof -i :18789

# 杀掉占用进程
kill -9 <PID>

# 或修改端口
openclaw config set gateway.port 18800

Docker Desktop + WSL2

如果需要沙箱隔离功能：

1. 安装 Docker Desktop
2. 设置中启用 Use the WSL 2 based engine
3. 在 Resources → WSL Integration 中启用你的 Ubuntu 发行版

# 验证 Docker 可用
docker --version
docker run hello-world