如何确认 OpenClaw 网关正常运行并访问 Web UI

本文记录了一次排查 OpenClaw Gateway 运行状态与 Web UI 访问问题的完整过程，适合本地部署用户参考。

---

背景

OpenClaw 是一款支持多消息渠道（WhatsApp、Discord、Telegram 等）的 AI 网关工具。本地部署时，Gateway 进程负责处理所有渠道通信，同时提供一个 Web UI 供用户查看对话（即"DM"界面）。

当你不确定 Gateway 是否在运行，或者不知道该访问哪个 URL 时，以下步骤可以帮你快速定位。

---

第一步：确认进程是否在运行

pgrep -f "openclaw"

有输出（PID 列表）说明进程正在运行，无输出则说明尚未启动。

本次排查输出了三个 PID，说明 Gateway 已正常启动。

---

第二步：查看监听端口

ss -ltnp | grep openclaw

输出示例：

LISTEN  127.0.0.1:18789   openclaw-gateway   # Gateway API
LISTEN  127.0.0.1:18791   openclaw-gateway   # Web UI
LISTEN  127.0.0.1:18792   openclaw-gateway   # 健康探测

三个端口各司其职：

端口	用途
18789	Gateway API
18791	Web UI
18792	健康探测（OK）

---

第三步：获取认证令牌

OpenClaw 默认启用 Token 认证，令牌存储在本地配置文件中：

cat ~/.openclaw/openclaw.json | python3 -m json.tool | grep token

输出示例：

"token": "xxxxxx"

---

第四步：验证各端点是否可访问

TOKEN="xxxxxx"

# Gateway API —— 令牌作为查询参数
curl -s -o /dev/null -w "%{http_code}" "http://localhost:18789/?token=$TOKEN"
# → 200

# Web UI —— 令牌作为 Bearer 请求头
curl -s -o /dev/null -w "%{http_code}" http://localhost:18791/ \
  -H "Authorization: Bearer $TOKEN"
# → 200

# 健康探测 —— 无需认证
curl -s http://localhost:18792/
# → OK

---

关键坑：18791 端口不接受查询参数

排查过程中发现一个容易踩的坑：

• 18789 端口：?token=xxx 查询参数 ✅
• 18791 端口：?token=xxx 查询参数 ❌，必须用 Authorization: Bearer 请求头 ✅

因此，在浏览器中打开 Web UI，应使用 Gateway API 地址，由其引导完成认证流程：

http://localhost:18789/?token=<your-token>

直接访问 http://localhost:18791/ 会收到 401 Unauthorized。

---

小结

步骤	命令
检查进程	pgrep -f "openclaw"
查看端口	ss -ltnp | grep openclaw
获取令牌	cat ~/.openclaw/openclaw.json | python3 -m json.tool | grep token
探测端点	curl -s -o /dev/null -w "%{http_code}" "http://localhost:18789/?token=$TOKEN"
打开 Web UI	浏览器访问 http://localhost:18789/?token=<your-token>

掌握这几条命令，本地部署的 OpenClaw 状态一目了然。