Openclaw网关启动问题

问题提示如下:
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.service user 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

常见踩坑点

  1. WSL 没开 systemd:就算执行 install,start 也会失败,systemctl --user直接报错
  2. WSL 修改 wsl.conf 后没有执行 wsl –shutdown:修改不生效
  3. 权限问题:不要用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 托管服务。

你可以选:

  1. 先做方案 A 升级 WSL,完整使用 systemd 托管服务;
  2. 或者直接用方案 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

发表回复

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