若你刚跑完官方 install.sh 或 install.ps1，终端却提示 找不到 Gateway、默认端口无监听、Control UI 打不开——这通常不是「你装错了」，而是 2026 年社区里高频出现的 半安装状态：CLI 已就位，但 Gateway 守护进程与 onboard 收尾未闭环。本文面向要把 OpenClaw 推进生产的开发者，给出 10 分钟验收阶梯、六步恢复 Runbook、对照表与上线路 checklist；并与站内 全平台安装避坑、Node 24 生产基线 分工阅读。
2026 年 3 月前后，上游社区集中反馈过一类问题：安装脚本在全新环境只刷新了已有 Gateway 服务，却未执行首次 daemon install，导致表面成功、实则 Gateway 缺席。即便你已升级到包含修复的版本，旧机器仍可能残留半安装痕迹。下面五条任意命中两条以上，就应走本文恢复路径，而不是直接重装整台主机。
openclaw-gateway 或等价命令不存在：which openclaw 有结果，但 Gateway 二进制或符号链接未写入 PATH 预期目录。
默认端口（常见 18789）无监听：openclaw gateway status 显示未运行或反复退出，且 openclaw logs 为空或极短。
Control UI / Dashboard 无响应：浏览器访问本地管理端超时；这与「鉴权失败」不同，多半是进程根本没起来。
onboard --install-daemon 曾报错或跳过：v2026.3.x 部分构建在 systemd 检查环节失败，留下「配置写了、服务没装」的缝隙。
升级后反而变坏：从旧版 npm 全局包升级后，PATH 上同时存在两个 openclaw，doctor 提示 split brain 或旧二进制闸门——应先读站内 升级分叉恢复，再回本文验收 Gateway。
仅渠道探测失败、Gateway 却显示 running：说明半安装已度过最危险阶段，应转读 鉴权排错专文，避免误删配置。
| 检查项 | 健康（可进生产） | 半安装（本文范围） | 伪成功（易误判） |
|---|---|---|---|
openclaw gateway status | Runtime: running；探针 ok | not running / 命令缺失 | running 但端口实际未监听（陈旧 PID 文件） |
openclaw doctor | 无阻塞项；配置 validate 通过 | 提示 daemon 未安装或 PATH 异常 | 仅 warning，被忽略未处理 |
channels status --probe | Connectivity probe: ok | 未配置渠道（可接受于纯 Gateway 阶段） | probe 失败却当作「装坏了」 |
| Node 运行时 | Node 24（或官方声明的最低 22.14+） | 混用系统 Node 与 nvm，导致 service 用户读不到 | 交互 shell 里 node -v 正确，systemd 单元里仍是旧版 |
「脚本最后一行绿色 ✓」不等于 Gateway 已托管——生产验收必须落到 status + doctor + 端口三件事上。
顺序很重要：先让 Gateway 能启动并持久化，再跑 onboard 补全模型与渠道；不要在进程不存在时反复改 openclaw.json。
冻结现场：记录 openclaw --version、which -a openclaw、安装方式（curl 脚本 / npm -g / git），避免同时改 Node 与配置。
跑官方诊断阶梯：openclaw status → openclaw gateway status → openclaw logs --follow（另开终端）→ openclaw doctor。
拉起 Gateway：openclaw gateway start；若提示 daemon 未安装，执行 openclaw onboard --install-daemon（按向导完成 Token 与最小配置）。
修复「CLI 有、Gateway 无」：在确认 Node 24 基线后，可执行 npm install -g openclaw --force 对齐全局包与二进制；容器环境请改走 Docker/Podman 路径而非强行 systemd。
版本策略：若卡在 v2026.3.2 类 daemon 回归，短期可锁定 v2026.3.1 或更新到含 PR #48649 修复的构建，并在变更单写明回滚点。
生产验收：openclaw channels status --probe、确认 loopback/Token、重启后复检；macOS 常驻请对照 远程 Mac launchd 专文，Linux 对照 Ubuntu systemd 部署。
# 10 分钟验收阶梯（2026 推荐顺序） openclaw status openclaw gateway status openclaw doctor openclaw gateway start openclaw onboard --install-daemon # 若 daemon 未安装 openclaw channels status --probe
提示：官方安装脚本在 macOS/Linux 上推荐 Node 24；生产环境请先完成 CVE-2026-25253 与 Node 24 基线，再执行本文恢复，避免在安全补丁未对齐时开放 Gateway。
注意：不要在半安装阶段把 Gateway 直接暴露到公网；默认应绑定 127.0.0.1，远程访问走 Tailscale 或反向隧道，详见站内 Gateway 安全与 Tailscale 专题。
onboard --install-daemon 解决「把 Gateway 变成可重启的服务」——两步缺一即半安装。doctor 与 gateway status 的定期探测记录；GitHub issue #48272 类问题说明「安装日志成功」不能替代进程级验收。把 Gateway 长期放在会睡眠的笔记本或与他人混用的开发机上，容易在系统更新后回到半安装边缘；而独占、长期在线的 macOS 节点更适合作为 Agent 网关宿主。若你需要像租 VPS 一样快速拿到可 SSH 维护、可重复跑验收脚本的 Mac 算力，NodeMini 的 Mac Mini 云端租赁通常是更优解：与 OpenClaw 远程模式、CI 构建同机部署等站内实践同一运维心智，便于把「安装后 10 分钟验收」固化进标准镜像与 Runbook。