跳转到主要内容

​
Windows (WSL2)

Windows 上的 OpenClaw 推荐通过 WSL2（推荐 Ubuntu）。CLI + Gateway 网关在 Linux 内运行，这保持了运行时的一致性并使工具兼容性大大提高（Node/Bun/pnpm、Linux 二进制文件、Skills）。原生 Windows 可能更棘手。WSL2 给你完整的 Linux 体验——一条命令安装：wsl --install。 原生 Windows 配套应用已在计划中。

​
安装（WSL2）

​
Gateway 网关

​
Gateway 网关服务安装（CLI）

在 WSL2 内：
或：
或：
出现提示时选择 Gateway service。 修复/迁移：

​
高级：通过 LAN 暴露 WSL 服务（portproxy）

WSL 有自己的虚拟网络。如果另一台机器需要访问在 WSL 内运行的服务（SSH、本地 TTS 服务器或 Gateway 网关），你必须将 Windows 端口转发到当前的 WSL IP。WSL IP 在重启后会改变，因此你可能需要刷新转发规则。 示例（以管理员身份运行 PowerShell）：
允许端口通过 Windows 防火墙（一次性）：
在 WSL 重启后刷新 portproxy：
注意事项：
  • 从另一台机器 SSH 目标是 Windows 主机 IP（示例：ssh user@windows-host -p 2222）。
  • 远程节点必须指向可访问的 Gateway 网关 URL（不是 127.0.0.1）；使用 openclaw status --all 确认。
  • 使用 listenaddress=0.0.0.0 进行 LAN 访问；127.0.0.1 仅保持本地访问。
  • 如果你想自动化，注册一个计划任务在登录时运行刷新步骤。

​
WSL2 分步安装

​
1）安装 WSL2 + Ubuntu

打开 PowerShell（管理员）：
如果 Windows 要求则重启。

​
2）启用 systemd（Gateway 网关安装所需）

在你的 WSL 终端中：
然后从 PowerShell：
重新打开 Ubuntu，然后验证：

​
3）安装 OpenClaw（在 WSL 内）

在 WSL 内按照 Linux 入门指南流程：
完整指南：入门指南

​
Windows 配套应用

我们还没有 Windows 配套应用。如果你想让它实现，欢迎贡献。