跳到主要内容

2.3 Windows 与 WSL2 安装

官方支持 Windows 原生与 WSL2；推荐优先走 WSL2。

路线选择​

  • 推荐：WSL2 + Ubuntu（稳定性更好）
  • 可选：Windows 原生 PowerShell

A. WSL2 路线（推荐）​

1) 安装 WSL2​

管理员 PowerShell：

wsl --install
# 或指定发行版
wsl --list --online
wsl --install -d Ubuntu-24.04

按提示重启 Windows。

2) 启用 systemd（安装 daemon 必需）​

在 WSL 终端执行：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

回到 PowerShell 执行：

wsl --shutdown

重开 Ubuntu 后验证：

systemctl --user status

3) 在 WSL 内执行官方一键安装​

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

脚本会自动完成：

  • 检测系统环境
  • 处理 Node 版本（若不满足会自动安装）
  • 安装 OpenClaw CLI

三、验证是否安装成功​

openclaw --version
openclaw doctor

如果 openclaw --version 输出版本号，说明 CLI 已可用。

四、运行 onboarding​

推荐命令（同时安装守护服务）：

openclaw onboard --install-daemon

你会进入交互式引导。下面按常见步骤给出“新手推荐选项”。

引导配置请看: 引导配置

4) 验证​

openclaw --version
openclaw doctor
openclaw gateway status
openclaw dashboard

B. Windows 原生路线（可选）​

管理员 PowerShell：

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

验证：

openclaw --version
openclaw doctor
openclaw gateway status

常见问题​

1) 安装后命令不可用​

node -v
npm prefix -g
$env:Path

检查 npm 全局路径是否在 PATH 中。

2) 不想安装后台服务​

可先跳过健康检查或前台运行：

openclaw onboard --non-interactive --skip-health
openclaw gateway run