OpenClaw 新手部署教程:WSL2 静默自启 + Windows 浏览器访问
这篇教程记录了从本地部署 OpenClaw 到实现「WSL2 启动后 OpenClaw 静默自启、关闭 WSL 窗口不影响服务、Windows 浏览器直接访问」的完整有效操作步骤适合新手参考。前置准备确保你已经完成WSL2 环境已安装并启用 WSL2推荐 Ubuntu 20.04/22.04Node.js 环境WSL2 内已安装 Node.js推荐 v18OpenClaw 安装通过 npm 全局安装 OpenClawnpminstall-gopenclaw第一步配置 OpenClaw systemd 服务核心让 OpenClaw 网关在 WSL2 启动时自动后台运行崩溃自动重启。1. 创建 systemd 服务文件在 WSL2 终端执行sudonano/etc/systemd/system/openclaw.service2. 写入服务配置最终稳定版完整复制以下内容注意替换占位符[Unit] DescriptionOpenClaw Gateway Afternetwork.target [Service] Useryour_username Groupyour_username WorkingDirectory/home/your_username ExecStart/usr/bin/node /home/your_username/.npm-global/bin/openclaw gateway --force Restartalways RestartSec2 [Install] WantedBymulti-user.target注意将your_username替换为你 WSL2 内的实际用户名。3. 保存并退出按CtrlO→ 回车 →CtrlX4. 启动服务并启用自启# 重载 systemd 配置sudosystemctl daemon-reload# 启动 OpenClaw 服务sudosystemctl start openclaw# 启用开机自启WSL2 启动时自动运行sudosystemctlenableopenclaw# 验证服务状态必须看到 active (running)sudosystemctl status openclaw第二步配置 sudo 免密码避免脚本输密码让脚本可以静默启动服务无需手动输入密码。1. 配置免密码规则在 WSL2 终端执行# 给当前用户配置 sudo 免密码echoyour_username ALL(ALL) NOPASSWD: ALL|sudotee/etc/sudoers.d/99-your_username-nopasswd# 给 root 用户也配置免密码双重保险echoroot ALL(ALL) NOPASSWD: ALL|sudotee-a/etc/sudoers.d/99-your_username-nopasswd# 设置正确的文件权限sudochmod0440 /etc/sudoers.d/99-your_username-nopasswd注意将your_username替换为你 WSL2 内的实际用户名。2. 验证免密码# 执行后无需输密码即为成功sudosystemctl status openclaw第三步配置 WSL2 后台常驻关闭窗口不关机让 WSL2 关闭终端窗口后继续运行服务不中断。1. 配置 WSL2 内的wsl.conf在 WSL2 终端执行sudonano/etc/wsl.conf写入以下内容[boot] systemdtrue [automount] enabledtrue optionsmetadata,umask22,fmask11保存CtrlO→ 回车 →CtrlX2. 配置 Windows 侧的.wslconfig全局 WSL2 配置按Win R输入%USERPROFILE%回车打开你的用户文件夹如C:\Users\YourWindowsUser新建一个文件命名为.wslconfig注意前面有个点没有后缀写入以下内容[wsl2] # 禁用 WSL 自动休眠永久后台运行 idleShutdownTimeout0 # 启用 localhost 转发确保 Windows 能访问 WSL 端口 localhostForwardingtrue3. 重启 WSL2 使配置生效以管理员身份打开 Windows PowerShell执行wsl--shutdown重新打开 WSL2 终端即可生效。第四步制作 Windows 自动化脚本开机自动启动 WSL OpenClaw静默无窗口新建开机自动启动WSL.vbsSet WshShell CreateObject(WScript.Shell) 等待10秒确保 Windows 开机、WSL 完全就绪 WScript.Sleep 10000 以 root 身份启动服务免密码、无窗口 WshShell.Run wsl -u root -- systemctl start openclaw, 0, True Set WshShell Nothing部署到开机启动文件夹按Win R输入shell:startup回车打开「开机启动」文件夹将开机自动启动WSL.vbs拖入该文件夹第五步验证与使用1. 验证服务自启启动 WSL2打开 WSL 终端窗口脚本会静默启动 OpenClaw 网关全程无窗口、无交互、无密码直接在 Windows 浏览器访问http://127.0.0.1:18789正常打开 OpenClaw 面板即为成功 ✅2. 日常使用打开面板在 WSL2 终端执行openclaw dashboard复制输出的带 Token 链接在浏览器打开关闭面板直接关闭浏览器即可不影响后台服务关闭 WSL 窗口在 Windows 不关机的情况下服务继续运行浏览器随时可访问日常运维命令命令作用wsl -u root -- systemctl status openclawWindows 端直接查看服务状态wsl -u root -- systemctl restart openclawWindows 端直接重启服务wsl --shutdown彻底关闭 WSL用于故障排查openclaw dashboardWSL 内获取带 Token 的面板链接最终效果✅ 启动 WSL → WSL 脚本静默启动 OpenClaw 网关全程无窗口、无交互、无密码✅ WSL 永久后台常驻关闭窗口不关机Windows 不关机的情况下✅ WSL 启动之后浏览器随时访问http://127.0.0.1:18789✅ 服务崩溃自动重启稳定可靠避坑指南路径问题所有配置文件中的用户名、路径必须替换为你 WSL2 内的实际值配置文件位置wsl.conf在 WSL2 内.wslconfig在 Windows 用户文件夹启动时序vbs 脚本中的WScript.Sleep 10000是为了避免开机网络未就绪导致启动失败可根据实际情况调整服务验证每次修改配置后务必用sudo systemctl status openclaw验证服务状态为active (running)希望这篇教程能帮到你如果有问题欢迎留言交流~