13.6 Windows WSL2

文档推荐通过 WSL2（首选 Ubuntu）而非原生 Windows 安装 OpenClaw，这样可以保持运行时一致性并提高工具兼容性。

关键安装步骤

初始设置

用户应在 WSL2 中按照 Linux 入门指南操作。过程包括克隆仓库、安装依赖项并运行入门命令。

Gateway 服务安装

文档提供三种命令选项：

# 选项 1：使用入门向导（推荐）
openclaw onboard --install-daemon

# 选项 2：直接安装 gateway
openclaw gateway install

# 选项 3：通过配置向导
openclaw configure
# 在提示时选择 Gateway 服务

启用 systemd

用户必须配置 WSL 以启用 systemd，这是 Gateway 安装正常运行所必需的。

编辑 /etc/wsl.conf 文件：

[boot]
systemd=true

然后在 PowerShell 中重启 WSL：

wsl --shutdown

高级网络配置

如需从局域网上的其他机器访问 WSL 内运行的服务，指南说明了使用 PowerShell 的 netsh 命令进行端口转发。这解决了"WSL 拥有自己的虚拟网络"的问题，由于 WSL IP 地址在重启后会改变，因此需要显式的转发配置。

端口转发设置

在 PowerShell（管理员模式）中运行：

# 获取 WSL IP 地址
wsl hostname -I

# 设置端口转发（将 WSL_IP 替换为上面获取的 IP）
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=WSL_IP

# 查看现有的端口转发规则
netsh interface portproxy show all

# 删除端口转发规则
netsh interface portproxy delete v4tov4 listenport=18789 listenaddress=0.0.0.0

当前限制

文档指出：

• 原生 Windows 安装仍未经测试，可能存在问题
• Windows 配套应用已列入计划但尚未可用