-
加载中…
-
Windows Installation Guide
OpenClaw on Windows
Two paths available — WSL2 is the recommended, stable route.
01 — System Requirements
Windows 版本
Windows 10 / 11
64-bit · Build 19041+（WSL2 需 21H1+）
Node.js
Node 24 （推荐）
最低 Node 22.19+ · 安装脚本自动处理
内存
4 GB 最低
日常建议 8 GB · 本地模型需 16 GB+
存储空间
10 GB
WSL2 发行版 + OpenClaw + 依赖
PowerShell
5.1 或更新
Windows 11 自带 7.x · 推荐以管理员运行
LLM API Key
至少一个
Anthropic / OpenAI / Google 等
02 — 路径 A · WSL2 安装
推荐 安装 WSL2 + Ubuntu 24.04
以管理员身份打开 PowerShell，执行下方命令。安装完成后若提示重启，请重启电脑，然后按提示设置 Linux 用户名和密码。
# PowerShell（管理员）
wsl --install -d Ubuntu-24.04
# 验证安装状态
wsl --list --verbose
开启 systemd（Gateway 守护进程必需）
在 Ubuntu 终端内写入配置，然后回到 PowerShell 重启 WSL，再重新打开 Ubuntu 验证。
# Ubuntu 终端内
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
# PowerShell 中重启 WSL
wsl --shutdown
# 重新打开 Ubuntu，验证 systemd 已启动
systemctl --user status
一键安装 OpenClaw
在 Ubuntu 终端内运行安装脚本。脚本自动检测系统 → 安装 Node 24 → 安装 OpenClaw CLI → 启动配置向导，全程约 2～5 分钟。
curl -fsSL https://openclaw.ai/install.sh | bash
完成 onboarding 配置向导
安装脚本结束后会自动进入向导，也可手动触发。向导依次询问：选择 LLM 提供商 → 填写 API Key → 是否安装 Gateway 守护进程（选 Yes）。
openclaw onboard --install-daemon
完成后 Gateway 在后台自动启动，监听端口 18789。可用浏览器访问 http://localhost:18789 确认控制台已加载。
（可选）开机自动启动 Gateway
让 Gateway 在 Windows 开机时自动运行，无需手动打开 WSL。
# WSL 内：允许无登录保持服务运行
sudo loginctl enable-linger "$(whoami)"
# WSL 内：注册 Gateway 用户服务
openclaw gateway install
# PowerShell（管理员）：Windows 启动时自动拉起 WSL
schtasks /create /tn "WSL Boot" ^
/tr "wsl.exe -d Ubuntu-24.04 --exec /bin/true" ^
/sc onstart /ru SYSTEM
03 — 路径 B · 原生 Windows
无需 WSL2 原生 Windows 路径目前无桌面伴侣 App，语音唤醒、屏幕录制等高级功能仅在 WSL2 路径下完整支持。核心 CLI 和 Gateway 功能可正常使用。
PowerShell 一键安装
以管理员身份打开 PowerShell，粘贴以下命令。脚本自动安装 Node.js 和 OpenClaw CLI。
iwr -useb https://openclaw.ai/install.ps1 | iex
安装 Gateway 服务
OpenClaw 优先尝试创建 Windows 计划任务；若被拒绝，自动回退到 Startup 文件夹登录项。
openclaw gateway install
openclaw gateway status --json
完成 onboarding
原生 Windows 建议加 --skip-health 跳过健康检查，避免 Gateway 未就绪时卡住。
openclaw onboard --non-interactive --skip-health
# 手动启动 Gateway
openclaw gateway run
04 — 验证安装
openclaw --version
确认 CLI 已正确安装
openclaw doctor
检测配置问题并给出修复建议
openclaw gateway status
确认 Gateway 守护进程正在运行
所有检查通过后，在浏览器打开 http://localhost:18789 即可进入 OpenClaw Web 控制台。
