OpenClaw 网关连接问题解决方案（device identity required）

来源类型： 故障排查指南
日期： 2026-03
标签： gateway, websocket, device-identity, troubleshooting, security

核心论点

"已断开与网关的连接。device identity required" 错误的本质是安全验证问题——OpenClaw 在 2026.2.22-2 版本后加强了安全验证，要求设备必须经过身份验证才能连接网关。根据不同使用场景提供了四种分级解决方案。

关键结论

• 问题本质：安全验证问题，非网络故障。新版本要求设备必须经过身份验证
• 方案一（最简单）：使用本地回环地址 http://127.0.0.1:端口 而非 LAN IP
• 方案二（局域网推荐）：配置 allowInsecureAuth: true，重启网关服务
• 方案三（最安全/生产环境）：设备配对和批准 —— openclaw devices approve <设备ID>
• 方案四（生产环境）：配置 HTTPS 代替 HTTP
• 四种场景对应：本地开发→方案一，局域网多设备→方案二，生产环境→方案三或四，云服务器→方案四+方案三
• 诊断流程：基础状态检查（openclaw status/doctor）→ 配置检查（config get）→ 设备状态检查（devices list）→ 网络连接检查
• 提供了一键修复脚本和设备批准脚本