OpenClaw Gateway:服务能起来,但浏览器访问报无法连接——一次排障复盘

一、现象

• 环境：Ubuntu，Gateway 端口 18789
• 操作：浏览器打开 http://192.168.31.247:18789/
• 结果：页面提示无法访问，常见为 ERR_CONNECTION_REFUSED（连接被拒绝）

现场信息：

openclaw gateway status

关注：Runtime: stopped / RPC probe: failed 等，说明当时探测到的网关不可用。

二、初步判断

• ERR_CONNECTION_REFUSED
  
   通常表示：目标地址/端口上没有进程在监听，或连接被系统直接拒绝（服务未运行、端口不对、瞬时退出等）。
• 需要区分两类问题：
1. 服务生命周期：是否前台运行、关终端后是否退出
2. 网络与防火墙：本机通、局域网不通时再查 ufw/安全组

三、关键线索

• 使用方式：手动执行 openclaw gateway
• 行为：关闭 shell 窗口后，浏览器再访问就不行

解释：前台进程随会话结束而退出 → 端口不再监听 → 浏览器表现为「无法访问」。

四、解决过程

1）让用户级 systemd 服务在断开会话后仍可运行

loginctl enable-linger root

2）若提示 unit 文件变更，先 reload

systemctl --user daemon-reload

3）启用并启动网关服务

systemctl --user enable --now openclaw-gateway.service

4）验证服务与端口

systemctl --user status openclaw-gateway.service --no-pagerss -lntp | rg 18789

5）失败时看日志

journalctl --user -u openclaw-gateway.service -n 200 --no-pager

6）若本机/同网段仍异常，再查防火墙（按需）

ufw status ufw allow 18789/tcp

五、结果

• openclaw-gateway.service 为 active (running)
• 18789 在监听（ss 能看到）
• 浏览器访问不再报连接被拒绝（至少先验证本机 127.0.0.1:18789，再验证局域网 IP）

六、复盘

现象是浏览器无法访问，但优先核对「服务是否持续运行 + 端口是否监听」；前台 openclaw gateway 会因关终端而退出，应改为 systemd 常驻并用日志定位异常。