Ubuntu 安装 OpenClaw 网关服务报错 Gateway service check failed 解决方法

所以 detail = "Command failed: systemctl --user is-enabled openclaw-gateway.service" — 而不是 "not-found"。

isSystemdUnitNotEnabled(detail) 检查 "not-found"，但 detail 字符串是错误消息，所以返回 false。代码继续执行并抛出异常。

复现步骤

1. 全新 Ubuntu 服务器，已启用 systemd user services
2. 通过 npm 全局安装 openclaw
3. 运行 openclaw gateway install --port 18789 --force
4. 观察错误

期望行为

gateway install 应识别退出码 4 / "not-found" 为 "服务尚未安装"，并继续创建服务文件。

建议修复

三选一：

1. execFileUtf8: 不再用 error.message 替换空的 stderr（或分开存储两者）
2. readSystemctlDetail: 当 stderr 包含 "Command failed" 时，优先使用 stdout
3. isSystemdServiceEnabled: 也直接检查 stdout 中的 unit-not-found 模式

临时解决方案

在调用 openclaw gateway start 前手动创建 systemd user service 文件：

mkdir -p ~/.config/systemd/user cat > ~/.config/systemd/user/openclaw-gateway.service << EOF [Unit] Description=OpenClaw Gateway After=network-online.target Wants=network-online.target [Service] ExecStart=$(which node) $(realpath $(which openclaw)) gateway run --port 18789 Restart=always RestartSec=5 KillMode=process WorkingDirectory=$HOME/.openclaw [Install] WantedBy=default.target EOF systemctl --user daemon-reload systemctl --user enable openclaw-gateway.service systemctl --user start openclaw-gateway.service 

备注

v2026.3.2 更新日志提到修复了 "container systemd checks"（#26089），但那仅覆盖 ENOENT/EACCES 情况 — 不包括这个 systemd 可用但单元尚不存在的退出码 4 场景。