Windows/WSL2 装 OpenClaw 最常见的五条误判签名
OpenClaw 在 2026 年的安装面同时覆盖 macOS、Linux 与 Windows（多经 WSL2）。Windows 侧故障常叠加三层：Node 运行时版本、systemd 用户会话是否可用、18789 是否被幽灵进程占用。运维若把三层压成「重装一遍」，就会在 2026.4.24 一类版本上陷入 30–50 秒崩溃循环，而真正阻塞点仍是用户级与系统级 Gateway 服务重复注册。建议变更单先勾选签名编号，再决定是清理端口、回退 dist-tag，还是把生产 Gateway 迁到云 Mac。
把 WSL 能 ping 通云 Mac 当成 Gateway 已健康：传输可达不等于 openclaw gateway status 为 active；Node 侧 remote URL 写错时，Windows 本地仍会独自崩溃重启。
未启用 WSL2 systemd 就执行 onboard --install-daemon：守护单元写入后无法由 user session 拉起，SSH 断开即进程消失，表现像「偶发掉线」。
在 Windows 宿主机与 WSL 内各装一套 Gateway：双监听争用 18789，日志呈现幽灵 EADDRINUSE，且 doctor 输出互相矛盾。
笔记本睡眠后怪渠道不回：消费级 Windows 休眠会冻结 WSL；生产 webhook 应落在不睡眠的云 Mac Master，Windows 仅作 Node 或控制台。
升级后 config key 漂移却不跑 doctor：跨小版本后旧键名仍留在 json 里，Gateway 进程能起但 channels probe 红灯，被误判为 Windows 防火墙。
给签名贴标签后再动模型路由。若你已在云 Mac 跑 Master，配对与 remote 接线应优先读 远程 Node 配对与跨区迁移；若 Gateway 从未在云主机验收，请先对照 无头 SSH 首小时清单，再在 Windows 上叠加 WSL 守护，否则会在抖动 Master 上叠出更多本地重启噪声。
Windows 原生、WSL2 与「云 Mac Gateway」三分法决策矩阵
2026 年社区共识并非「Windows 不能跑 OpenClaw」，而是把 7×24 控制面与渠道 webhook 放在稳定宿主。下表粗粒度对齐团队常见组合：仅本机实验、WSL 开发机自建 Gateway、以及推荐的「云 Mac Master + Windows Node」分裂拓扑。分裂拓扑与全平台部署手册互补，见 Gateway 全平台部署与故障恢复。
| 维度 | Windows 原生 (PowerShell) | WSL2 + systemd | 云 Mac Gateway + Win Node |
|---|---|---|---|
| 安装入口 | install.ps1 | install.sh（Ubuntu 内） | 云 Mac：install.sh；Win：仅 CLI/Node |
| 守护形态 | 计划任务，易弹窗 | 用户级 systemd unit | 云 Mac：LaunchAgent；Win：可选无守护 |
| 7×24 渠道 | 睡眠/更新打断风险高 | WSL 暂停即断 | 渠道仅在云 Mac，最稳 |
| 排错复杂度 | 路径与权限分裂 | 需懂 systemd + 端口 | 分层：Win 看 Node，云 Mac 看 Gateway |
| 2026 推荐场景 | 短期演示 | 本机复现生产脚本 | 跨区小团队、自动化负责人 |
生产渠道不要赌笔记本不睡眠；把 Gateway 放在云 Mac loopback，Windows 只跑 node run。
选定分裂拓扑后，文档应写明：哪台云 Mac 接 webhook、Windows 是否仅 openclaw node run --remote wss://...。实验期可在 WSL 临时起 Gateway 做对照，但不要与云 Mac Master 同时接同一渠道 token，否则会出现双消费与静默丢消息。Docker 与裸金属差异见 Docker 与 install.sh 双路径对照；版本钉扎见 升级与回滚 Runbook。
WSL2 前置检查、Node 24 验收与「幽灵 EADDRINUSE」分层排错
在 WSL 内执行生产级 openclaw onboard --install-daemon 前，先确认 Node ≥ 22.16（推荐 24） 与 systemd=true。2026 年 4 月下旬部分 2026.4.24 构建在 WSL2 上曾报告：Gateway 日志显示启动，但 Control UI 不可达，并伴随 30–50 秒一次的 EADDRINUSE 循环——社区缓解之一是钉扎到 2026.4.22 并清理重复 systemd 单元。下列命令块为值班骨架，请按工单环境替换发行版路径。
grep -q 'systemd=true' /etc/wsl.conf || echo '[boot]' >> /etc/wsl.conf && echo 'systemd=true' >> /etc/wsl.conf node -v curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon systemctl --user status openclaw-gateway lsof -i :18789 openclaw doctor openclaw gateway status
若 lsof 显示 18789 已被占用但 gateway status 为 stopped，优先查残留 openclaw 进程与/etc/systemd/system 与 ~/.config/systemd/user 是否各有一份 unit。清理后只保留用户级服务，再 systemctl --user daemon-reload 重启。仍循环时记录 openclaw --version，按 Runbook 评估是否从 2026.4.24 回退，并在变更窗口跑 openclaw doctor --fix。Windows 宿主机防火墙若需本地调试 Control UI，仅对开发机放行 18789，生产仍推荐 Tailscale Serve 指向云 Mac Master，而非把笔记本端口暴露到公网。
提示：每次 onboard 前后各存档 systemctl --user status 与 lsof -i :18789 输出，便于区分「双实例」与「版本缺陷」。
六步 Runbook：从 WSL 验收到云 Mac Master 渠道冒烟
冻结拓扑：记录 Win 角色（仅 Node / 临时 Gateway）、云 Mac 城区、渠道是否只挂 Master。
WSL 前置：启用 systemd，验证 node -v ≥ 22.16，必要时在 Ubuntu 内单独安装 Node 24。
云 Mac 部署 Master：按首小时清单完成 install.sh、onboard、LaunchAgent；确认 loopback 18789 与 gateway status 正常。
Win/WSL 侧接 remote：配置 node run --remote 或 Control UI 指向 Master WSS；若 1008 则在 Master 执行 devices approve（见远程 Node 文）。
清理 Win 本地 Gateway（若采用分裂）：停止 WSL 用户级 unit，避免与 Master 争用同一渠道配置。
Master 渠道冒烟：在云 Mac 跑 channels probe，发真实入站消息；Win 侧仅验证工具执行，不把 webhook 指回笔记本。
三条值班硬阈值与六区云 Mac Gateway 选型
端口争用红线：同一台 WSL 实例若 10 分钟内出现 3 次以上 EADDRINUSE 且进程表存在 2 个以上 openclaw-gateway，应视为双实例，先停服清理再谈升级。
Node 版本下限：官方 2026 安装文档以 Node 24 为推荐基线；低于 22.16 时 doctor 可能通过但插件加载异常，应在工单注明 node -v 截图。
分裂拓扑验收：Master 恢复后 10 分钟内至少 3 次 channels probe；Win 休眠一次后仅 Node 应可重连，渠道不得依赖笔记本在线。
注意：阈值为值班沟通口径，不构成厂商 SLA。
把 Gateway 绑在 Windows 笔记本上，会重新引入睡眠、自动更新重启与 WSL 冻结；纯 Linux VPS 虽便宜，却与 macOS 浏览器自动化、公证链工具脱节。以裸金属云 Mac 为 Master、Windows 仅作 Node 或控制台，能在 Apple 工具链邻近、loopback 纪律与可预测换租窗口之间取得平衡。对要 7×24 渠道、又不愿赌消费级硬件在线率的团队，MESHLAUNCH 的 Mac Mini 云端租赁通常是更优解：建议目标城区日租先完整跑通六步与一次宿主机重启，再锁月租。容量与下单见 租赁价格 与 帮助中心。
先 lsof -i :18789 与 systemctl --user status openclaw-gateway，清理双 unit 与残留进程；核对 2026.4.24 是否需钉扎回退。对照 全平台 Gateway 手册；下单见 价格页。
可以用于短期实验。生产渠道建议迁到云 Mac Master，Win 仅 node run。部署步骤见 无头 SSH 首小时清单。
检查 /etc/wsl.conf 的 systemd 是否仍启用，并跑 openclaw doctor。分裂拓扑下渠道应在云 Mac 仍在线；帮助见 帮助中心。