OpenClaw Gateway 安装失败：systemctl --user is-enabled unavailable 排查与解决（完整踩坑记录）
说明：仅供学习使用，请勿用于非法用途，若有侵权，请联系博主删除
作者：zhu6201976
最近在安装 OpenClaw Gateway 时，遇到了一个比较奇怪的错误：
systemctl is-enabled unavailable Command failed: systemctl --user is-enabled openclaw-gateway.service
看起来只是一个简单的 systemd 错误，但实际上背后涉及：
- systemd user service
- Node.js / nvm 环境
- PATH 环境变量
- CLI daemon 启动方式
这篇文章记录了 完整的排查过程 + 最终解决方案。
一、运行环境
我的环境如下：
Window11 + WSL2
Ubuntu 24.04.4 LTS
nvm + Node v24.14.0
OpenClaw 2026.3.2
安装 OpenClaw 后执行：
openclaw onboard --install-daemon
出现错误：
Gateway service check failed:
Error: systemctl is-enabled unavailable
Command failed: systemctl --user is-enabled openclaw-gateway.service
二、OpenClaw Gateway 架构
OpenClaw Gateway 实际上是通过 systemd user service 运行的。
架构大致如下：
OpenClaw CLI
│
▼
openclaw gateway install
│
▼
systemctl --user
│
▼
systemd user service
│
▼
openclaw-gateway.service
│
▼
Node runtime (nvm)
│
▼
OpenClaw Gateway
因此任何一层出问题都会导致 Gateway 无法启动。
三、systemd 启动流程
当执行：
openclaw gateway start
实际运行流程是：
openclaw gateway start
│
▼
systemctl --user restart openclaw-gateway.service
│
▼
systemd user service
│
▼
ExecStart
│
▼
node openclaw gateway run
所以本质上就是：
systemd 负责守护 Node 进程。
四、第一个问题：systemd user service 未启用
先检查 service 状态：
systemctl --user is-enabled openclaw-gateway.service
输出：
disabled
启用 service：
systemctl --user enable openclaw-gateway.service
五、最终解决方案
找到 node 和 openclaw 的路径：
which node
which openclaw
输出：
/home/tesla/.nvm/versions/node/v24.14.0/bin/node
/home/tesla/.nvm/versions/node/v24.14.0/bin/openclaw
然后修改 service 文件：
~/.config/systemd/user/openclaw-gateway.service
完整配置：
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
Type=simple
Environment="PATH=/home/tesla/.nvm/versions/node/v24.14.0/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/tesla/.nvm/versions/node/v24.14.0/bin/openclaw gateway run
Restart=always
RestartSec=5
[Install]
WantedBy=default.target
六、重新加载 systemd
执行：
systemctl --user daemon-reload
systemctl --user restart openclaw-gateway
检查状态：
systemctl --user status openclaw-gateway
输出：
Active: active (running)
Main PID: node
说明服务已经正常运行。
七、最终运行效果
● openclaw-gateway.service - OpenClaw Gateway
Loaded: loaded
Active: active (running)
Main PID: node
Gateway 成功启动 🎉
八、总结（踩坑记录）
这次安装 OpenClaw Gateway 一共踩了 三个坑：
1 systemd user service 未启用
需要执行：
systemctl --user enable openclaw-gateway.service
2 systemd 不加载 nvm 环境
解决：
Environment="PATH=..."
3 ExecStart 必须使用绝对路径
否则会出现：
openclaw: command not found
九、经验总结
如果使用 nvm + systemd 运行 Node 服务，一定要注意：
systemd 不会加载 .bashrc
systemd 不会加载 nvm
systemd PATH 很干净
最稳定的方式是：
使用绝对路径
显式指定 PATH
十、成功展示
