腾讯云服务器 OpenClaw 网关连接问题专项解决方案
腾讯云服务器 OpenClaw 网关连接问题专项解决方案
来源类型： 故障排查指南
日期： 2026-03
标签： tencent-cloud, gateway, websocket, nginx, troubleshooting, deployment
核心论点
腾讯云服务器上 OpenClaw 网关连接问题（页面能访问但显示"已断开与网关的连接"）的核心原因是 WebSocket 连接失败，主要由腾讯云安全组限制、跨域问题（CORS）、WebSocket 协议支持不完整导致。生产环境推荐使用 Nginx 反向代理 + HTTPS。
关键结论
- 问题本质：页面能访问（HTTP 正常）但 WebSocket 连接断开，根因是腾讯云安全组未开放 WebSocket 所需端口
- 方案一（最重要）：检查安全组，开放 TCP 18789 端口
- 方案二（推荐生产）：配置 Nginx 反向代理，正确处理 WebSocket Upgrade 头
- 方案三（生产必须）：配置 HTTPS（Let's Encrypt 免费证书）
- 方案四：调整 OpenClaw 配置（增加 WebSocket 超时、允许 CORS、开启调试日志）
- 推荐部署架构：用户浏览器 → 腾讯云安全组 → Nginx (80/443) → OpenClaw (18789)
- 一键修复脚本：提供完整 bash 脚本，按序执行停止服务、备份配置、调整配置、重启服务、检查状态