Windows（WSL2）
Windows（WSL2）
推荐在 Windows 上通过 WSL2 运行 OpenClaw（推荐 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这能保持运行时一致，并使
工具链兼容性高得多（Node/Bun/pnpm、Linux 二进制文件、Skills）。原生
Windows 可能会更棘手。WSL2 可提供完整的 Linux 体验 —— 只需一条命令
即可安装：wsl --install。
原生 Windows 配套应用已在规划中。
安装（WSL2）
- 入门指南（请在 WSL 内使用）
- 安装与更新
- 官方 WSL2 指南（Microsoft）：https://learn.microsoft.com/windows/wsl/install
原生 Windows 状态
原生 Windows CLI 流程正在改进，但 WSL2 仍然是推荐路径。
当前在原生 Windows 上运行良好的内容：
- 通过
install.ps1使用网站安装器 - 本地 CLI 用法，例如
openclaw --version、openclaw doctor和openclaw plugins list --json - 嵌入式 local-agent/provider 冒烟测试，例如：
当前注意事项：
- 除非你传递
--skip-health，否则openclaw onboard --non-interactive仍然要求本地 Gateway 网关可访问 openclaw onboard --non-interactive --install-daemon和openclaw gateway install会优先尝试 Windows Scheduled Tasks- 如果拒绝创建 Scheduled Task，OpenClaw 会回退到每用户 Startup 文件夹登录项，并立即启动 Gateway 网关
- 如果
schtasks本身卡住或停止响应，OpenClaw 现在会快速中止该路径并回退，而不是无限挂起 - 在可用时仍优先使用 Scheduled Tasks，因为它们能提供更好的 supervisor 状态
如果你只想使用原生 CLI，而不安装 Gateway 网关服务，可使用以下任一方式：
如果你确实想在原生 Windows 上使用受管启动：
如果无法创建 Scheduled Task，回退服务模式仍会通过当前用户的 Startup 文件夹在登录后自动启动。
Gateway 网关
Gateway 网关服务安装（CLI）
在 WSL2 内：
或者：
或者：
出现提示时，选择 Gateway 服务。
修复/迁移：
在 Windows 登录前自动启动 Gateway 网关
对于无头设置，请确保完整的启动链即使在无人登录 Windows 时也能运行。
1）在未登录时保持用户服务运行
在 WSL 内：
2）安装 OpenClaw Gateway 网关用户服务
在 WSL 内：
3）在 Windows 启动时自动启动 WSL
以管理员身份打开 PowerShell：
将 Ubuntu 替换为以下命令输出中的发行版名称：
验证启动链
重启后（在 Windows 登录前），在 WSL 中检查：
高级：通过局域网暴露 WSL 服务（portproxy）
WSL 有自己的虚拟网络。如果另一台机器需要访问 在 WSL 内运行的服务（SSH、本地 TTS 服务器或 Gateway 网关），你必须 将 Windows 端口转发到当前的 WSL IP。WSL IP 会在重启后变化， 因此你可能需要刷新转发规则。
示例（以管理员身份打开 PowerShell）：
允许该端口通过 Windows 防火墙（一次性）：
在 WSL 重启后刷新 portproxy：
说明：
- 来自另一台机器的 SSH 应指向Windows 主机 IP（例如：
ext user@windows-host -p 2222）。 - 远程节点必须指向可访问的 Gateway 网关 URL（而不是
127.0.0.1）；请使用openclaw status --all进行确认。 - 使用
listenaddress=0.0.0.0可供局域网访问；127.0.0.1则仅限本地。 - 如果你希望自动执行此操作，请注册一个 Scheduled Task，在登录时运行刷新 步骤。
分步 WSL2 安装
1）安装 WSL2 + Ubuntu
打开 PowerShell（管理员）：
如果 Windows 提示，请重启。
2）启用 systemd（Gateway 网关安装所必需）
在你的 WSL 终端中：
然后在 PowerShell 中运行：
重新打开 Ubuntu，然后验证：
3）安装 OpenClaw（在 WSL 内）
在 WSL 内按照 Linux 入门指南流程操作：
完整指南：入门指南
Windows 配套应用
我们还没有 Windows 配套应用。如果你想推动这件事发生，欢迎 贡献。