WSL2 OpenClaw 开机自启动(官方推荐方案,systemd + linger + Windows 任务计划)

WSL2 默认特性:Windows 开机不会自动启动 WSL,WSL 闲置会自动关机,所以要两件事:

  1. WSL 内启用 systemd,安装 openclaw gateway 服务
  2. 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

  1. 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 用户运行

任务计划手动配置备选(图形界面)

  1. Win 搜索「任务计划程序」→ 创建任务
  2. 常规:名称 OpenClaw WSL Boot
  3. 触发器:新建 → 计算机启动时
  4. 操作:启动程序 程序:wsl.exe 添加参数:-d Ubuntu --exec dbus-launch true
  5. 勾选:不管用户是否登录都运行

测试验证流程

  1. PowerShell wsl --shutdown 完全关闭 WSL
  2. 重启电脑
  3. 打开 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

排查常见坑

  1. WSL 启动后 openclaw 不跑:loginctl show-user $USER | grep Linger,Linger=yes 才正常;
  2. 一段时间自动掉线:就是缺少dbus-launch true任务计划,WSL 空闲休眠;
  3. systemctl --user报错:确认/etc/wsl.conf systemd=true,执行 wsl –shutdown 重启 WSL;
  4. 端口无法外部访问:记得 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

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注