问题提示如下:
zxb@创世纪网络备用电脑:~$ openclaw gateway start
OpenClaw 2026.9.8 (fc23bc8) — You had me at ‘openclaw gateway start.’
Gateway service disabled.
Tip: openclaw gateway install
Tip: openclaw gateway start
Tip: systemctl –user start openclaw-gateway.service
Tip: WSL2 needs systemd enabled: edit /etc/wsl.conf with [boot]\nsystemd=true
Tip: Then run: wsl –shutdown (from PowerShell) and reopen your distro.
Tip: Verify: systemctl –user status
问题分析:
Gateway service disabled.
含义:Gateway 服务还没有安装注册到 systemd 用户单元,只是二进制存在,服务未部署,提示里已经给出核心命令:openclaw gateway install 同时你是 WSL2 环境,额外要求开启 systemd。
完整操作步骤(按顺序执行)
1. 先确认 WSL2 是否开启 systemd
cat /etc/wsl.conf
如果输出没有下面内容,编辑文件:
nano /etc/wsl.conf
写入:
[boot]
systemd=true
保存退出:Ctrl+O →回车 →Ctrl+X
⚠️ 必须在 Windows PowerShell 执行关闭 WSL,不能在 WSL 内重启
# Windows PowerShell
wsl --shutdown
重新打开你的 WSL 终端,验证 systemd:
systemctl --user status
不报错、能正常输出说明 systemd 用户实例正常。
2. 安装 OpenClaw gateway 服务
回到 WSL 终端执行:
openclaw gateway install
这个命令会:
- 生成
openclaw-gateway.serviceuser systemd unit - 启用自启动
3. 启动网关服务
openclaw gateway start
# 或者用 systemd 原生命令
systemctl --user start openclaw-gateway.service
4. 查看运行状态
systemctl --user status openclaw-gateway.service
看到 active (running) 即为成功。
常用排查命令
# 查看日志
journalctl --user -u openclaw-gateway.service -f
# 停止服务
systemctl --user stop openclaw-gateway.service
# 设置开机自启(install一般会自动enable,保险起见)
systemctl --user enable openclaw-gateway.service
常见踩坑点
- WSL 没开 systemd:就算执行 install,start 也会失败,
systemctl --user直接报错 - WSL 修改 wsl.conf 后没有执行 wsl –shutdown:修改不生效
- 权限问题:不要用
sudo执行openclaw gateway install/start,这是用户级 systemd 服务(–user),root 会创建在 root 用户单元,无法正常使用
执行完 openclaw gateway install 之后把 status 的输出贴给我,我帮你看是否正常。
zxb@创世纪网络备用电脑:~$ cat /etc/wsl.conf
[boot]
systemd=true
zxb@创世纪网络备用电脑:~$
✅ wsl.conf 配置已经正确
文件内容:
[boot]
systemd=true
但修改 wsl.conf 之后必须执行 wsl –shutdown才能生效,只改文件没用。
第一步:Windows PowerShell(管理员不用也行)执行
wsl --shutdown
然后完全关闭当前 WSL 终端窗口,重新打开。
第二步:重新进入 WSL,验证 systemd 用户实例
systemctl --user status
✅ 正常:会列出用户服务列表,不报错 ❌ 异常:提示 Failed to connect to bus,说明 systemd 还是没启动成功,需要再次检查 + 重启 WSL。
第三步:安装 OpenClaw Gateway 服务
openclaw gateway install
执行完成后,再启动:
openclaw gateway start
第四步:查看网关运行状态
systemctl --user status openclaw-gateway.service
把 systemctl --user status 的输出发给我,确认 systemd 是否就绪。
小提醒:全程不要加 sudo,openclaw gateway 是用户级服务,sudo 会装到 root 单元,会导致后续找不到服务。
如果执行 systemctl --user status 报 Failed to connect to bus: No such file or directory,说明 wsl shutdown 没生效,尝试:
# PowerShell
wsl --terminate Ubuntu
wsl --shutdown
替换 Ubuntu 为你的发行版名称(wsl -l -v 查看)。
zxb@创世纪网络备用电脑:~\(systemctl --user status
Failed to connect to user scope bus via local transport:\)DBUS_SESSION_BUS_ADDRESS and \(XDG_RUNTIME_DIR not defined (consider using --machine=<user>@.host --user to connect to bus of other user)
zxb@创世纪网络备用电脑:~\)
错误原因
Failed to connect to user scope bus via local transport: $DBUS_SESSION_BUS_ADDRESS and $XDG_RUNTIME_DIR not defined
含义:systemd 全局已经启动,但是用户级 systemd(user manager)没有正常拉起,缺少用户会话环境变量。 WSL2 开启 systemd=true 后,默认不会自动启动用户 systemd 会话,需要 linger(用户常驻会话)。
步骤 1:先确认 systemd 全局是否正常
ps -p 1
✅ 正常输出:systemd 是 PID 1 ❌ 如果不是 systemd,说明 wsl –shutdown 没生效,回到 PowerShell 重新执行:
wsl --shutdown
关闭所有 WSL 窗口,再重新打开 WSL。
步骤 2:开启用户 linger(关键,让用户 systemd 常驻)
sudo loginctl enable-linger $USER
$USER 就是你的 zxb,这条命令允许你的用户在没有登录终端时,依然保留 systemd 用户管理器。
步骤 3:临时注入环境变量,测试
export XDG_RUNTIME_DIR="/run/user/$(id -u)"
export DBUS_SESSION_BUS_ADDRESS="unix:path=${XDG_RUNTIME_DIR}/bus"
再执行:
systemctl --user status
此时不再报错,就成功了。
步骤 4:永久写入环境变量(加到~/.bashrc)
nano ~/.bashrc
在文件末尾追加:
export XDG_RUNTIME_DIR="/run/user/$(id -u)"
export DBUS_SESSION_BUS_ADDRESS="unix:path=${XDG_RUNTIME_DIR}/bus"
保存 Ctrl+O →回车,退出 Ctrl+X 生效:
source ~/.bashrc
步骤 5:再次测试 OpenClaw Gateway
openclaw gateway install
openclaw gateway start
systemctl --user status openclaw-gateway.service
备选方案(如果上面还是不行)
直接用 machinectl 启动完整用户会话,进入新 shell:
machinectl shell zxb@.host
在新弹出的 shell 里面执行:
openclaw gateway install
openclaw gateway start
额外检查
wsl --version
如果 WSL 版本比较旧,建议在 PowerShell 执行更新:
wsl --update
你先执行 ps -p 1,把输出发给我确认 PID1 是不是 systemd。
zxb@创世纪网络备用电脑:~$ ps -p 1
PID TTY TIME CMD
1 ? 00:00:00 init
zxb@创世纪网络备用电脑:~$
核心原因
/etc/wsl.conf 写对了,但WSL 版本太低 / Windows 版本不支持,导致 systemd=true 配置被忽略,PID1 依旧是 init。
WSL systemd 支持要求:WSL 版本 ≥0.67.6;Windows10 需要 22H2 以上新版本,Windows11 原生支持Microsoft …。
第一步:PowerShell 查看 WSL 版本
打开 Windows PowerShell(普通权限即可)
wsl --version
如果提示
Invalid command line option: --version,说明你的 WSL 是很老的内置版本,不支持 systemd,这就是根源!
情况 A:版本过低,直接更新 WSL
PowerShell 执行:
wsl --update
更新完成后,关闭所有 WSL 窗口,执行:
wsl --shutdown
重进 WSL,再次检查:
ps -p 1
第二步:确认发行版类型(WSL1 还是 WSL2)
PowerShell:
wsl -l -v
看 VERSION 那一列,必须是 2。如果是 1:
wsl --set-version 你的发行版名字 2
然后再 wsl --shutdown。
备选方案:不启用 systemd,绕过这个问题直接跑 OpenClaw Gateway
如果你不想升级 WSL,OpenClaw Gateway 不一定非要 systemd 托管,可以直接前台运行,跳过
openclaw gateway install(systemd 服务安装)。
直接在 WSL 终端启动网关(前台):
openclaw gateway run
这个命令会直接启动网关,不依赖 systemd,缺点是终端窗口不能关,一关服务就停。适合测试。
如果你需要后台常驻,又不想折腾 systemd,可以用 screen 或者 tmux 托管进程:
# 安装screen
sudo apt update && sudo apt install screen -y
# 创建会话
screen -S openclaw-gw
# 在screen里面启动网关
openclaw gateway run
按 Ctrl+A,再按 D 脱离会话,网关后台跑; 后续恢复:screen -r openclaw-gw
简单总结:
- 想使用
openclaw gateway start/systemctl --user:必须升级 WSL 并确保是 WSL2,systemd=true 生效- 只是跑 OpenClaw 做测试:直接
openclaw gateway run,绕过 systemd
你把 wsl --version 的输出贴给我。
PS C:\Windows\system32> wsl -l -v
NAME STATE VERSION
- Ubuntu Running 2
PS C:\Windows\system32>
结论:发行版是 WSL2 没错,但WSL 内核版本太旧,不支持 systemd=true
wsl --version 如果报错,就代表是旧版 inbox WSL(内置老版本),这个版本虽然支持 WSL2,但是不识别 /etc/wsl.conf 的 [boot] systemd=true,所以 PID1 永远是 init,无法切换成 systemdMicrosoft …。
微软文档明确:systemd 支持需要 WSL 版本 ≥0.67.6;老内置 WSL 不支持该配置项。
方案 A(推荐,根治,可以使用 openclaw gateway install/start)
PowerShell(管理员)执行 WSL 更新:
wsl --update
等待更新完成。 关闭所有 WSL 窗口,执行:
wsl --shutdown
重新打开 WSL,验证:
ps -p 1
✅ 此时 PID1 变成systemd,就可以继续:
sudo loginctl enable-linger $USER
systemctl --user status
openclaw gateway install
openclaw gateway start
systemctl --user status openclaw-gateway.service
方案 B(不升级 WSL,直接跑 OpenClaw 网关,绕过 systemd)
如果你不想升级 WSL,完全可以不用 openclaw gateway install,直接前台运行网关:
openclaw gateway run
缺点:终端不能关,一关网关停止。
后台常驻方案(screen 托管,推荐)
sudo apt update && sudo apt install screen -y
# 创建后台会话
screen -S openclaw-gw
# 在screen里面启动网关
openclaw gateway run
按 Ctrl+A 松开,再按 D,脱离会话,网关继续后台运行。
- 查看日志 / 回到会话:
screen -r openclaw-gw - 终止网关:在会话里
Ctrl+C
这个方式完全避开 systemd,可以直接正常使用 OpenClaw Gateway 所有功能,只是不用 systemd 托管服务。
你可以选:
- 先做方案 A 升级 WSL,完整使用 systemd 托管服务;
- 或者直接用方案 B
openclaw gateway run+ screen,快速跑通网关。
zxb@[localhost](https://localhost):~$ ps -p 1
PID TTY TIME CMD
1 ? 00:00:00 systemd
zxb@[localhost](https://localhost):~$ systemctl --user status
● [localhost](https://localhost)
State: running
Units: 168 loaded (incl. loaded aliases)
Jobs: 0 queued
Failed: 0 units
Since: Sun 2026-10-04 13:04:27 CST; 37s ago
systemd: 259.5-0ubuntu3.4
Tainted: unmerged-bin
CGroup: /user.slice/user-1000.slice/user@1000.service
└─init.scope
├─467 /usr/lib/systemd/systemd --user
└─469 "(sd-pam)"
zxb@[localhost](https://localhost):~$
太好了!现在 systemd 用户实例正常运行,systemctl --user 不再报错,可以继续部署 OpenClaw Gateway。
1. 安装网关 systemd 用户服务
openclaw gateway install
这条命令会生成
openclaw-gateway.service用户单元并启用自启动。
2. 启动网关服务
openclaw gateway start
等价于
systemctl --user start openclaw-gateway.service
3. 查看运行状态
systemctl --user status openclaw-gateway.service
预期成功输出:active (running)
4. 实时查看网关日志(排错用)
journalctl --user -u openclaw-gateway.service -f
常用补充命令
# 停止网关
systemctl --user stop openclaw-gateway.service
# 重启网关
systemctl --user restart openclaw-gateway.service
把 systemctl --user status openclaw-gateway.service 的执行结果贴给我,看看网关是否正常拉起。
小提示: 如果你后续重启 WSL,
systemctl --user用户服务默认不会自动启动,之前我们提到过 linger,需要执行一次:sudo loginctl enable-linger $USER执行一次永久生效,重启 WSL 后网关可自动启动。可以现在就执行这条。
zxb@[localhost](https://localhost):~$ openclaw gateway start
│
◇
OpenClaw 2026.9.8 (fc23bc8) — Self-hosted, self-updating, self-aware (just kidding... unless?).
Gateway service disabled.
Tip: openclaw gateway install
Tip: openclaw gateway start
Tip: systemctl --user start openclaw-gateway.service
zxb@[localhost](https://localhost):~$
现象
Gateway service disabled. 提示很明确:服务单元还没安装注册,必须先执行
openclaw gateway install,start只是启动已安装的服务。
1. 执行安装
openclaw gateway install
执行完观察输出,正常会提示:
Created user systemd unit openclaw-gateway.service Enabled openclaw-gateway.service
2. 安装完成后,再启动
openclaw gateway start
或者直接用 systemd:
systemctl --user start openclaw-gateway.service
3. 查看状态
systemctl --user status openclaw-gateway.service
4. 可选:开启 linger(WSL 重启后自动拉起用户服务)
sudo loginctl enable-linger $USER
如果 install 之后依然提示 disabled
检查单元文件是否生成:
ls -la ~/.config/systemd/user/openclaw-gateway.service
- 文件存在:说明 install 成功,直接 start
- 文件不存在:install 命令执行失败,贴出
openclaw gateway install完整输出给我。
先跑 openclaw gateway install,把完整输出发过来。
Windows 10 系统下WSL2 安装部署 OpenClaw:https://www.hao0564.com/6253.html
