Windows 平台

OpenClaw 支持原生 Windows 和 WSL2。WSL2 是更稳定的路径，推荐用于完整体验。原生 Windows 伴侣应用规划中。

WSL2（推荐）

WSL2 内的 CLI、Gateway 和工具链与 Linux 完全兼容。

完整安装步骤

# 1. 安装 WSL2 + Ubuntu
wsl --install
# 或指定发行版
wsl --install -d Ubuntu-24.04

# 2. 启用 systemd（WSL 内）
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

# 重启 WSL
wsl --shutdown

# 3. 安装 OpenClaw（WSL 内）
git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm build && pnpm ui:build
pnpm openclaw onboard --install-daemon

原生 Windows 状态

目前可用功能：

• install.ps1 网站安装器
• 基本 CLI：openclaw --version、openclaw doctor、openclaw plugins list --json
• 本地 Agent 测试

当前限制：

• openclaw onboard --non-interactive 需要可达的本地 Gateway（或加 --skip-health）
• Scheduled Task 创建被拒时，回退到用户 Startup 文件夹登录项

# 仅 CLI，不安装 Gateway 服务
openclaw onboard --non-interactive --skip-health
openclaw gateway run
 
# 安装托管启动
openclaw gateway install
openclaw gateway status --json

Windows 启动前自动运行 Gateway

# WSL 内：允许无登录运行用户服务
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

# PowerShell（管理员）：Windows 启动时自动启动 WSL
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

WSL 服务暴露到 LAN（portproxy）

WSL 有独立虚拟网络，需要端口转发才能从其他机器访问：

$WslIp = (wsl -d Ubuntu-24.04 -- hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=2222 `
  connectaddress=$WslIp connectport=22

相关链接

• platforms-index — 平台总览
• platform-linux — Linux 平台