Dashboard 卡在 Loading Chat？—— WebSocket 连接错误地址排查实录

问题描述

某天打开 OpenClaw Dashboard，页面加载后一直卡在 "Loading chat..."，浏览器控制台显示：

WebSocket connection to 'ws://100.x.y.z:18789/ws?token=...' failed:
Error during WebSocket handshake: Unexpected response code: 403

排查过程

第一阶段：服务端检查

服务端一切正常，问题不在 Gateway。

第二阶段：前端分析

检查前端 JavaScript 如何构建 WebSocket URL：

// 前端代码逻辑
const wsUrl = `${location.protocol === "https:" ? "wss" : "ws"}://${location.host}/ws`;

代码本身没问题，location.host 应该返回当前页面的 host。但浏览器实际连接的却是：

实际访问: http://127.0.0.1:18789/
WebSocket 尝试: ws://100.x.y.z:18789/  ← 错误！

第三阶段：环境检查

Tailscale 完全关闭，但 WebSocket 仍尝试连接 Tailscale IP！

根本原因

核心问题：浏览器缓存（包括 Service Worker）保存了之前通过 Tailscale IP 访问时的资源，导致 location.host 被污染。

解决方案

预防措施

1. 统一访问方式

始终使用 127.0.0.1 或 localhost 访问本地 Dashboard，避免混用 Tailscale IP。

2. 定期清理

# macOS 清理 Service Worker 缓存
rm -rf ~/Library/Application\ Support/Google/Chrome/Default/Service\ Worker/Cache*
rm -rf ~/Library/Application\ Support/Google/Chrome/Default/Cache/*

3. 使用带 Token 的完整 URL

# 每次使用最新 Token
openclaw dashboard --no-open

# 复制完整 URL（包含 #token=xxx）
# 在无痕窗口打开

排查流程总结

诊断命令速查

# 检查 Gateway 状态
openclaw gateway status

# 检查端口监听
lsof -i :18789

# 检查健康状态
curl http://127.0.0.1:18789/health

# 检查 Tailscale 状态
tailscale status

# 生成新的 Dashboard URL
openclaw dashboard --no-open

# 重启 Gateway
openclaw gateway restart