网关故障排查 (Gateway Troubleshooting)

来源： wiki/sources/gateway-device-identity-fix, wiki/sources/tencent-cloud-gateway-fix
相关概念： wiki/concepts/multi-channel-gateway, wiki/concepts/openclaw

OpenClaw 网关连接问题的系统化排查和解决方案体系。

要点

• device identity required 错误：2026.2.22-2 版本后加强安全验证，需设备身份认证。解决方案分级：127.0.0.1 回环地址访问（最简单）→ allowInsecureAuth（局域网）→ 设备配对批准（最安全）→ HTTPS（生产环境）
• 腾讯云网关连接失败：页面能访问但 WebSocket 断开，根因为安全组限制和 WebSocket 协议处理。推荐使用 Nginx 反向代理正确处理 WebSocket Upgrade 头
• 诊断工具链：openclaw status → openclaw logs --follow → openclaw doctor [--fix] → openclaw config get gateway → openclaw devices list

与 OpenClaw 的关系

网关连接问题是 OpenClaw 部署中最常见的故障类型，系统化的故障排查流程是保障 OpenClaw 服务稳定运行的关键。腾讯云等云服务器环境因安全组和 WebSocket 限制问题，是故障高发场景。