升级后 Gateway / 通道「看起来像挂了」的几种真因
常见三类：二进制已升级但 launchd 仍指旧路径、Node 次版本漂移致 Gateway 秒退、通道侧缓存旧会话密钥。日韩首包 RTT 敏感易先报警；港新适合作灰度第一站；美西长连多、升级窗需单列。健康检查若只测 TCP 不测握手，易「探针全绿、业务全红」。
灰度顺序：先回滚止血，再迁移数据
| 阶段 | 动作要点 | 验收信号 |
|---|---|---|
| P0 止血 | 切流量到上一版镜像或包目录；冻结技能热更新 | Gateway 日志恢复监听；通道能收到心跳 |
| P1 对齐 | 锁定 Node LTS 三元组与安装前缀；核对 plist 的 ProgramArguments | 本机 curl 健康检查与外部探针一致 |
| P2 迁移 | 复制工作区快照、通道令牌与密钥引用路径；双写旧新配置目录 | 影子节点跑通首条业务消息 |
| P3 切流 | 按区域 5%→25%→100% 放量；保留一键回滚标签 | 各区域 SLO 无回归 |
区域策略：日韩港新与美西怎么分工
配置与通道联调放港新；长时任务与日志落盘放美西。首尔、东京作第二灰度池可分散 DNS/证书风险。灰度期可临时只让跳板访问 Gateway，降低公网误切。
常见误区
不要在「通道仍报错」时反复全量重装——先比对安装前缀与 plist，再决定是回滚包还是迁移数据；否则容易把旧令牌覆盖掉，扩大故障面。
数据迁移清单：哪些必须「停写」再拷贝
向量索引、会话记忆与技能缓存须在 Gateway 停写或只读下快照；导出通道绑定与密钥引用，勿拷不可移植的绝对路径。按 curl 到首条通道 的顺序可快速区分网络层与握手失败。
16GB、24GB 与 M4 Pro：灰度期的算力切分
- 16GB 节点：适合单区域影子 Gateway 与轻量通道探针；避免与大型本地模型同机争用。
- 24GB 节点：可并行跑旧新双进程做短时对比验证，注意统一内存压力下的 GC 抖动对通道延迟的影响。
- M4 Pro：适合作为「全量切流」前的压测与日志聚合机；与多小节点并联时，用队列隔离避免单点日志拖垮通道。
守护进程与技能审计
launchd 域与用户会话不一致会「手动起、重启挂」。灰度期锁技能热更与自动更新，回滚后做冷启。系统排错见 launchd + ClawHub 审计。
灰度要的是十分钟内可回到已知良好版，且快照可证迁移前后一致。
回滚与迁移的「双人复核」检查表
变更单强制勾选：包哈希、plist 与安装前缀、通道令牌路径、区域 DNS/证书；双人交叉签字，降低 PATH、钥匙串与代理漂移。
| 检查项 | 负责人 A | 负责人 B |
|---|---|---|
| 旧版包 / 镜像摘要 | 记哈希 | 交叉比对 |
| plist 与安装前缀 | 导出 diff | 核对 ProgramArguments |
| 通道令牌与密钥 | 清单 | 只读挂载 |
多区域时把可回滚写进发布清单，成本低于事后救火。
常见问题
回滚后通道仍 401 / 握手失败？
清客户端会话缓存，校时钟与令牌轮换；影子节点用最小配置复现。
双网关能长期并存吗？
短期可，须打流量标签与日志前缀防记忆分叉；切流后尽快下线旧实例。
在 Mac mini 上跑 OpenClaw 灰度，更省心
回滚与双进程验证依赖稳定 macOS 会话与统一内存：Mac mini M4 待机功耗低，适合作 7×24 影子 Gateway；Unix 环境加 Homebrew 便于锁 Node/CLI。Gatekeeper、SIP、FileVault 降低公网暴露面。按区域拆 16GB、24GB、M4 Pro 并联，长期综合成本常优于杂牌小机加长链路排障人力。
若你正为多区域节点选型，现在就用可快照、可快回的 Mac mini 把本手册跑通——这是把灰度做稳的高性价比起点。