OpenClaw Gateway 连接断开与超时问题排查
问题现象
在 OpenClaw v2026.3.13 版本中,执行 CLI 命令时网关频繁断开或重启。
PS C:\Users\13400> openclaw cron list
12:32:05 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
12:32:05 [plugins] feishu_chat: Registered feishu_chat tool
12:32:05 [plugins] feishu_wiki: Registered feishu_wiki tool
12:32:05 [plugins] feishu_drive: Registered feishu_drive tool
12:32:05 [plugins] feishu_bitable: Registered bitable tools
gateway connect failed: Error: gateway closed (1000):
Error: gateway closed (1000 normal closure): no close reason
Gateway target: ws://127.0.0.1:18789
Source: local loopback
Config: C:\Users\13400\.openclaw\openclaw.json
Bind: loopback
12:32:05 [ws] handshake timeout conn=1db993d9-b28c-4531-bbd1-6bee24a0f7a4 remote=127.0.0.1
12:32:05 [ws] closed before connect conn=1db993d9-b28c-4531-bbd1-6bee24a0f7a4 remote=127.0.0.1 fwd=n/a origin=n/a host=127.0.0.1:18789 ua=n/a code=1000 reason=n/a
原因分析
网关客户端在连接握手时默认超时时间为 2 秒,而服务器的握手超时为 3 秒。这导致 CLI 命令在认证超过 2 秒时失败,触发 gateway closed (1000 normal closure) 错误。
解决方案
将默认延迟从 2000 毫秒调整为 4000 毫秒,以确保客户端在服务器完成认证前不会超时。配置项为 connectChallengeTimeoutMs。
相关修复
GitHub 已提交 Bug 修复并合并至主分支,等待最新发版即可解决此问题。
- GitHub Issue: #45918

