Repository navigation
[bug] OpenClaw Gateway 升级到 2026.5.12 后 ClawPanel 连接协议不匹配 #279
Description
问题描述
当 OpenClaw Gateway 通过 openclaw update 升级到最新版本后（当前最新为 2026.5.12），ClawPanel 内置的 Control UI 协议版本与 Gateway 不匹配，导致 ClawPanel 显示「Gateway 连接未就绪」。
复现步骤：
- 安装 ClawPanel（bundled OpenClaw 版本较旧）
- Gateway 升级到 2026.5.12（运行
openclaw update） - 打开 ClawPanel，Gateway 连接失败，报「协议不匹配」
环境：
- ClawPanel: v0.15.3
- Gateway: 2026.5.12
- OS: Linux
期望行为
ClawPanel 能兼容更新后的 Gateway 版本。
临时解决方案
使用浏览器直接访问 Gateway Control UI（http://127.0.0.1:18789），浏览器版本可以正常连接。
报告者：@Berg-E5
Activity
luntion commentedon May 15, 2026
win版本也是一样，升级到5.9及更新的版本gateway协议版本不一致，没法进行会话了
1186258278 commentedon May 22, 2026
感谢反馈，这个问题先作为 OpenClaw Gateway 2026.5.12 协议不匹配的主跟踪 Issue 保留。
目前公开版本里已有相关兼容与诊断改动：v0.16.0 起在服务页/聊天调试页展示 Gateway WebSocket 握手协议版本；后续 v0.16.x 继续补了 Gateway 启动、版本识别和最新 OpenClaw 版本兼容相关修复。当前最新版本是 v0.16.5。
建议先升级到 ClawPanel v0.16.5，并把 OpenClaw 升级到当前推荐版本后再验证一次。如果升级后仍出现
protocol mismatch，麻烦补充：minProtocol / maxProtocol / expectedProtocol的完整片段。我会把 #278、#281 先合并到这个 Issue 里继续跟踪，避免同一问题分散。
1186258278 commentedon May 22, 2026
这条先补
question，继续作为 Gateway 协议不匹配主跟踪 Issue。维护者前面已经说明：后续版本加入了 Gateway WebSocket 握手协议版本展示，并在 v0.16.x 持续补了 Gateway 启动、版本识别和最新 OpenClaw 兼容相关修复。但这条涉及 OpenClaw/Gateway 快速演进，不能只按旧版本判断已解决。
麻烦在当前最新 ClawPanel + 当前推荐 OpenClaw/Gateway 版本下复测。如果仍有
protocol mismatch，请补充服务页或聊天调试页显示的协议版本，以及日志里的minProtocol / maxProtocol / expectedProtocol片段。crackerfly commentedon May 25, 2026
升级 到 clawpanel 0.16.5 + openclaw 2026.5.9
windows11环境
wss还是连不上网关 ， openclaw 日志如下
16:57:13 [session-store] Saved session for default: sessionId=a1bb1a44-1684-4f8c-966a-57dcde54460b, lastSeq=3
16:57:15 [gateway] security audit: device access upgrade requested reason=role-upgrade device=cbb30e9513fc73b52f3e40f50c55e0fdc32465ae879fb42ae32a4450ae3d752a ip=unknown-ip auth=token roleFrom= roleTo=operator scopesFrom=operator.admin,operator.approvals,operator.pairing,operator.read,operator.write scopesTo=operator.admin,operator.approvals,operator.pairing,operator.read,operator.write client=openclaw-control-ui conn=79ccec9d-1af7-489a-a7b0-7fca32a7175e
16:57:15 [ws] closed before connect conn=79ccec9d-1af7-489a-a7b0-7fca32a7175e peer=127.0.0.1:61231->127.0.0.1:18789 remote=127.0.0.1 fwd=n/a origin=http://tauri.localhost host=127.0.0.1:18789 ua=Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36 Edg/148.0.0.0 code=1008 reason=pairing required: device is asking for a higher role than currently approved (requestId: 84a1a779-ee8f-4d0d-b665-27bccc4