1. 项目概述OpenClaw 是一个跨平台的智能体开发框架在 Windows 平台上通过 WSL2 提供最接近原生 Linux 的运行时环境。本教程将详细讲解如何在 Windows 11/10 系统上通过 WSL2 完整部署 OpenClaw 的 Gateway 网关服务并实现开机自启和局域网访问。2. 环境准备2.1 系统要求检查Windows 10 版本 2004 或更高建议使用 Windows 11 21H264位处理器x86-64 或 ARM64虚拟化功能已启用可通过任务管理器→性能选项卡确认至少 4GB 可用内存建议 8GB提示在 PowerShell 中运行systeminfo | find System Type可快速确认系统架构2.2 WSL2 基础安装以管理员身份启动 PowerShell 执行wsl --install安装完成后重启系统验证安装wsl --list --verbose正常应显示默认安装的 Ubuntu 发行版及其 WSL 版本。3. WSL 环境配置3.1 发行版选择与初始化推荐使用 Ubuntu LTS 版本wsl --install -d Ubuntu-22.04安装完成后首次启动会要求设置用户名和密码。3.2 启用 systemd 支持在 WSL 终端中执行sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue EOF然后退出所有 WSL 会话在 PowerShell 中执行wsl --shutdown wsl -d Ubuntu-22.043.3 基础工具安装更新软件源并安装必要工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git dbus-x114. OpenClaw 安装与配置4.1 核心组件安装执行官方一键安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后验证openclaw --version openclaw doctor4.2 Gateway 服务配置启用 linger 确保用户服务持久化sudo loginctl enable-linger $(whoami)安装并启动 Gateway 服务openclaw gateway install systemctl --user enable --now openclaw-gateway.service检查服务状态systemctl --user status openclaw-gateway.service5. Windows 集成配置5.1 开机自启动设置在管理员 PowerShell 中创建计划任务$distro Ubuntu-22.04 schtasks /create /tn WSL Boot /tr wsl.exe -d $distro --exec dbus-launch true /sc onstart /ru $env:USERNAME5.2 端口转发配置将 WSL 内的服务暴露给局域网以 SSH 为例$distro Ubuntu-22.04 $listenPort 2222 $targetPort 22 $wslIp (wsl -d $distro -- hostname -I).Trim().Split( )[0] netsh interface portproxy add v4tov4 listenaddress0.0.0.0 listenport$listenPort connectaddress$wslIp connectport$targetPort New-NetFirewallRule -DisplayName WSL SSH $listenPort -Direction Inbound -Protocol TCP -LocalPort $listenPort -Action Allow6. 验证与测试6.1 基础功能验证检查 Gateway 状态openclaw gateway status --json测试节点通信openclaw nodes ping6.2 远程访问测试从同局域网的另一台设备ssh usernamewindows_host_ip -p 22227. 常见问题排查7.1 WSL 网络问题如果遇到网络连接异常wsl --shutdown7.2 服务启动失败检查日志定位问题journalctl --user -u openclaw-gateway.service -b7.3 端口冲突处理查看已占用端口netstat -ano | findstr :22228. 进阶配置建议8.1 资源限制调整在/etc/wsl.conf中添加[memory] limit6GB [processors] count48.2 磁盘性能优化启用元数据缓存[automount] options metadata,umask22,fmask11通过以上步骤我们建立了完整的 OpenClaw WSL2 运行环境。实际使用中发现定期执行wsl --shutdown可以解决大多数奇怪的网络和服务问题。对于生产环境建议配置日志轮转和监控告警。
Windows WSL2部署OpenClaw网关服务教程
1. 项目概述OpenClaw 是一个跨平台的智能体开发框架在 Windows 平台上通过 WSL2 提供最接近原生 Linux 的运行时环境。本教程将详细讲解如何在 Windows 11/10 系统上通过 WSL2 完整部署 OpenClaw 的 Gateway 网关服务并实现开机自启和局域网访问。2. 环境准备2.1 系统要求检查Windows 10 版本 2004 或更高建议使用 Windows 11 21H264位处理器x86-64 或 ARM64虚拟化功能已启用可通过任务管理器→性能选项卡确认至少 4GB 可用内存建议 8GB提示在 PowerShell 中运行systeminfo | find System Type可快速确认系统架构2.2 WSL2 基础安装以管理员身份启动 PowerShell 执行wsl --install安装完成后重启系统验证安装wsl --list --verbose正常应显示默认安装的 Ubuntu 发行版及其 WSL 版本。3. WSL 环境配置3.1 发行版选择与初始化推荐使用 Ubuntu LTS 版本wsl --install -d Ubuntu-22.04安装完成后首次启动会要求设置用户名和密码。3.2 启用 systemd 支持在 WSL 终端中执行sudo tee /etc/wsl.conf /dev/null EOF [boot] systemdtrue EOF然后退出所有 WSL 会话在 PowerShell 中执行wsl --shutdown wsl -d Ubuntu-22.043.3 基础工具安装更新软件源并安装必要工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git dbus-x114. OpenClaw 安装与配置4.1 核心组件安装执行官方一键安装脚本curl -fsSL https://openclaw.ai/install.sh | bash安装完成后验证openclaw --version openclaw doctor4.2 Gateway 服务配置启用 linger 确保用户服务持久化sudo loginctl enable-linger $(whoami)安装并启动 Gateway 服务openclaw gateway install systemctl --user enable --now openclaw-gateway.service检查服务状态systemctl --user status openclaw-gateway.service5. Windows 集成配置5.1 开机自启动设置在管理员 PowerShell 中创建计划任务$distro Ubuntu-22.04 schtasks /create /tn WSL Boot /tr wsl.exe -d $distro --exec dbus-launch true /sc onstart /ru $env:USERNAME5.2 端口转发配置将 WSL 内的服务暴露给局域网以 SSH 为例$distro Ubuntu-22.04 $listenPort 2222 $targetPort 22 $wslIp (wsl -d $distro -- hostname -I).Trim().Split( )[0] netsh interface portproxy add v4tov4 listenaddress0.0.0.0 listenport$listenPort connectaddress$wslIp connectport$targetPort New-NetFirewallRule -DisplayName WSL SSH $listenPort -Direction Inbound -Protocol TCP -LocalPort $listenPort -Action Allow6. 验证与测试6.1 基础功能验证检查 Gateway 状态openclaw gateway status --json测试节点通信openclaw nodes ping6.2 远程访问测试从同局域网的另一台设备ssh usernamewindows_host_ip -p 22227. 常见问题排查7.1 WSL 网络问题如果遇到网络连接异常wsl --shutdown7.2 服务启动失败检查日志定位问题journalctl --user -u openclaw-gateway.service -b7.3 端口冲突处理查看已占用端口netstat -ano | findstr :22228. 进阶配置建议8.1 资源限制调整在/etc/wsl.conf中添加[memory] limit6GB [processors] count48.2 磁盘性能优化启用元数据缓存[automount] options metadata,umask22,fmask11通过以上步骤我们建立了完整的 OpenClaw WSL2 运行环境。实际使用中发现定期执行wsl --shutdown可以解决大多数奇怪的网络和服务问题。对于生产环境建议配置日志轮转和监控告警。
