WSL2 默认特性:Windows 开机不会自动启动 WSL,WSL 闲置会自动关机,所以要两件事:
- WSL 内启用 systemd,安装 openclaw gateway 服务
- Windows 任务计划开机拉起 WSL,防止 WSL 自动休眠退出OpenClaw
前置检查(WSL 内 Ubuntu/Debian)
# 检查wsl版本,建议 >=0.67.6
wsl --version
步骤 1:WSL2 开启 systemd(必须)
sudo tee /etc/wsl.conf <<EOF
[boot]
systemd=true
EOF
PowerShell 执行关闭 WSL 生效:
wsl --shutdown
重新打开 WSL,验证 systemd:
systemctl --user
步骤 2:安装 OpenClaw Gateway 服务 + 启用 linger(关键,注销后服务继续跑)
# 安装gateway systemd user服务(自动生成 ~/.config/systemd/user/openclaw-gateway.service)
openclaw gateway install
# 启用用户linger,就算不登录WSL,user systemd也能跑
sudo loginctl enable-linger "$(whoami)"
# 启动并设置开机自启
systemctl --user enable --now openclaw-gateway
# 查看状态
systemctl --user status openclaw-gateway
openclaw gateway status
linger 作用:WSL 启动后,不需要登录 Linux 用户,user 级 systemd 服务也会运行,否则你关闭 WSL 终端服务就停了OpenClaw
步骤 3:Windows 任务计划,开机唤醒 WSL(headless 无人值守必做)
问题:WSL 空闲一段时间会自动终止发行版进程,导致 OpenClaw 掉线。官方方案开机启动一个 dbus 保持 WSL 不退出OpenClaw
- PowerShell(管理员)查看你的发行版名字
wsl --list --verbose
示例名字:Ubuntu,替换下面命令里的 Ubuntu 为你的发行版名称
schtasks /create /tn "WSL-Boot-OpenClaw" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"
参数说明:
/sc onstart:Windows 开机触发dbus-launch true:解决 WSL >=2.6.1.0 空闲自动关闭子系统 bug(官方指定)OpenClaw/ru "$env:USERNAME":使用当前 Windows 用户运行
任务计划手动配置备选(图形界面)
- Win 搜索「任务计划程序」→ 创建任务
- 常规:名称 OpenClaw WSL Boot
- 触发器:新建 → 计算机启动时
- 操作:启动程序 程序:
wsl.exe添加参数:-d Ubuntu --exec dbus-launch true - 勾选:不管用户是否登录都运行
测试验证流程
- PowerShell
wsl --shutdown完全关闭 WSL - 重启电脑
- 打开 WSL,执行:
systemctl --user status openclaw-gateway
openclaw doctor
看到 active (running),gateway 正常,即为成功。
手动自建 service 文件(如果 openclaw gateway install 失败时备用)
mkdir -p ~/.config/systemd/user
nano ~/.config/systemd/user/openclaw-gateway.service
写入:
[Unit]
Description=OpenClaw Gateway
After=network-online.target
Wants=network-online.target
[Service]
ExecStart=/usr/local/bin/openclaw gateway
Restart=always
RestartSec=5
[Install]
WantedBy=default.target
保存退出,重载并启用:
systemctl --user daemon-reload
systemctl --user enable --now openclaw-gateway
排查常见坑
- WSL 启动后 openclaw 不跑:
loginctl show-user $USER | grep Linger,Linger=yes 才正常; - 一段时间自动掉线:就是缺少
dbus-launch true任务计划,WSL 空闲休眠; systemctl --user报错:确认/etc/wsl.confsystemd=true,执行 wsl –shutdown 重启 WSL;- 端口无法外部访问:记得 WSL 端口转发,或者 WSL mirror 网络模式。
简易备选方案(不使用 systemd,适合不想改 wsl.conf)
Windows 任务计划开机执行 bat 脚本,直接拉起 openclaw 前台运行
@echo off
wsl -d Ubuntu -u yourlinuxuser -- bash -c "openclaw gateway start --foreground"
缺点:会挂一个控制台窗口,关闭窗口服务停止,不推荐长期后台运行。
WSL下网络相关问题豆包问答归档:https://www.hao0564.com/6309.html
