openclaw-release-2026-W35-external-gateway-supervision

近期版本分析 (Recent Release Analysis)
v2026.8.1-beta.3 (Pre-release)
发布于 2026-08-24,npm / container images 上同步
v2026.8.1-beta.3,GitHub Actions32687267214/32689503061/32680190375完成 preflight + publication + 89 个官方插件的 tarball 完整性核对。
Breaking Changes / Security
- External Gateway lifecycle supervision:新增
OPENCLAW_SUPERVISOR_MODE=external,允许 OCM 这类外部 lifecycle owner 接管 Gateway 重启行为;保留 verified restart 与 deferral 语义,但显式阻断 native service mutation 与 self-update,并提供 versioned atomic restart-handoff consume contract。对任何把 Gateway 托管在 OCM / systemd / k8s sidecar 之下的部署,这是默认语义变更,升级前必须确认当前 supervisor 是 native 还是 external。
Notable Changes
- GPT-5.6 Sol / Terra / Luna / Ultra reasoning:四档推理档位在 OpenClaw 与 Codex runtime 同时启用,
/model与 fallback 链路上保持 model、runtime、thinking 选择的原子切换;新增 live matrix coverage 验证两套 harness 的 reasoning 档位都能落地。 - Control UI first-run setup 续接:已验证的 model setup 现在会顺流推进到 Custodian,并在 web app 就绪后提供可选的 Channels 引导;首次部署者减少了一次显式跳转。
- Puppeteer-compatible CDP relay:浏览器扩展 relay 端点补齐
Target.getBrowserContexts与/json/listtarget descriptor,Puppeteer 系客户端(chrome-devtools-mcp)能直接驱动 paired Chrome 而不再弹 remote-debugging 权限;新增openclaw browser extension cdp打印端点 + auth header。 - Compact verified SQLite backup:
openclaw backup sqlite create|list|verify|restore落地「fresh-target-only」恢复语义,避免误覆盖活跃数据库。 - Shared durable ingress monitors for channel plugins:插件 SDK 引入统一的 admission、polling、pruning、claim identity validation、adoption handoff、shutdown lifecycle,IRC / Synology Chat / Google Chat 三个 channel 已迁到 shared monitor;后续 channel plugin 默认走同一份 durable ingress 模板。
- Codex runtime pin:
@openclaw/codex@2026.8.1-beta.3锁定0.149.1的@openai/codexmanaged runtime,便于跨平台复现 GPT-5.6 reasoning 行为。
Bug Fixes
- GPT-5.6 reasoning fallback:在 Codex harness 上 Sol / Terra / Luna 推理档位回退不再因为 thinking selection drift 而 silently 切回默认档;
/model链路上现在保持 model + runtime + thinking 三者原子。 - Control UI first-run 转 Custodian 阶段:避免 model setup 完成但 Custodian 状态未 attach 时出现的「半完成态」,升级到 v2026.8.1-beta.3 后首次启动会显式补齐 Custodian 的 attach 步骤。
- Puppeteer CDP auth header:扩展 relay 端点暴露的 auth header 现在会随 paired Chrome 重启而 invalidate,旧的 CDP client 不再因为 token 残留而继续访问失效端点。
本地机器状态 (Local Machine Status)
- Core: 2026.3.13
- Plugin openclaw-qqbot: v1.5.7
- Gateway: local loopback
升级必要性与指令 (Upgrade Guide)
本周 v2026.8.1-beta.3 把外部 Gateway 生命周期监督提升为 first-class 入口,同时补齐 GPT-5.6 四档 reasoning、Control UI first-run 续接、Puppeteer CDP relay 与 compact SQLite 备份。OPENCLAW_SUPERVISOR_MODE=external 是其中最值得提前识别的「默认语义变更」:本机当前以 Windows + local loopback + QQBot plugin 为主,目前仍走 native supervision 路径,但升级到 2026.8.1-beta.3 之后若引入 OCM / k8s sidecar / 外部 supervisor 接管 Gateway 重启,需要显式声明 OPENCLAW_SUPERVISOR_MODE=external,否则 native service mutation 会被阻断,self-update 也会走「external handoff consume contract」而不是直接重启。GPT-5.6 reasoning 四档在本机若未启用 Codex OAuth 可暂时忽略,但 /model 与 fallback 链路上 thinking 档位的原子语义对后续统一 reasoning 行为是直接收益面。
升级命令
# 执行系统更新
openclaw update run
# 检查环境健康状况
openclaw doctor
# 自动修复发现的问题
openclaw doctor --fix