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 配套应用。如果你想让它实现,欢迎贡献。 Last modified on February 21, 2026