2026-05-09 无头租用的云上 OpenClaw onboard --install-daemon、Node 24+、PATH 与 launchd 日志，以及 openclaw doctor 排查（香港 / 东京 / 首尔 / 新加坡 / 美国）
租用构建机上最常见的 OpenClaw 回退往往不是「玄学」：交互式 SSH 能解析 /opt/homebrew/bin/node，而 launchd 进程的 PATH 被裁短；或是在 Node 22 环境里跑 onboarding，而上游已要求 Node 24+。把 openclaw onboard --install-daemon 当成与 Xcode 版本钉同级别的基础设施任务：运行时语义化写入仓库，plist 里的 EnvironmentVariables 对齐 密钥与环境变量，装完立刻用 健康探测 curl 冒烟。延伸阅读：安装部署指南、网关重启语义见 会话状态 checkpoint；为轮转日志留出 Mac mini M4 NVMe 裕量再上传中心化。
运维快照：为何 onboard 在 Mac CI 宿主上仍会断裂
团队共用 Apple Silicon 租赁机既要跑 Xcode又要跑网关。多套包管理器（Homebrew 全局 npm、volta、pnpm store）共存时，onboarding 生成的 plist 默认 Node 能被确定解析——一旦交互与批处理上下文漂移，网关可能带着空密钥启动，磁盘上的 .env 却看起来无误。
launchctl print 输出逐字校对。
以 Node 24+ 为前提的运行时
根据上游文档，onboarding 前应安装 Node.js 24 或更高；省略该约束会出现原生模块间歇安装失败、doctor 报 TLS。用 nix/asdf/tarball/受控 Homebrew Bundle 任选你们标准链路，并让 plist 重用同一个绝对路径的解释器。
- 架构对齐 — 网关账号只用 arm64 二进制；拒绝 Rosetta node。
- 并发 — 同一 UID 上避免并行 SSH 会话同时 global npm upgrade。
- 完整性 — 离线区域拉 tarball 要带校验和。
npm / pnpm / bun 的前缀一致性
每类宿主选单一主链路。pnpm 须在 plist 中显式导出 PNPM_HOME；bun 要补 BUN_INSTALL。在香港、东京、首尔、新加坡与美国克隆镜像时仍用同款包管理调用 OpenClaw 本身。
# 守护进程化前先做交互自检
hash -r
command -v node
node -v
openclaw --version
onboard --install-daemon 之后的 launchd 接线
命令结束会在用户 LaunchAgents 注册 plist；立即按 Sonoma/Sequoia 建议走 launchctl bootstrap——老习惯 load 会绊倒迁移镜像的团队。按需收紧 ThrottleInterval 与磁盘/网络密集型智能体场景的 SoftResourceLimits。
StandardOutPath / Err 与 ~/.openclaw/logs
stdout/stderr 文件若未配置等价于静默崩溃。优先轮转 ~/.openclaw/logs；上送日志前剥离密钥，时间戳对齐 launchctl 视图做跨地域 RCA。
# failover 演练时可并行 tail
/usr/bin/log stream --predicate 'process == "node"' --level debug
openclaw doctor：按序排查的信号
onboarding、改 plist、以及每周混沌演练后都跑一遍。关注点含 Node ABI、模型端点连通、状态目录写权限与插件钩子。告警当 backlog，切生产流量前应零致命项。
- Node 绿灯但网络红——查出口 TLS 检测设备。
- 磁盘红——先清障或扩容再改配置。
- 插件报错——对齐可选包的语义化漂移。
Doctor 与日志分流矩阵
| 现象 | doctor 提示 | 首选修复 |
|---|---|---|
| 守护进程秒退 | 解释器缺失 | 写死 NODE_BINARY 并重载 plist |
| 令牌范围陈旧 | API 轮转告警 | 经 launchd 认可流程轮换密钥并重载 env |
| 夜间无声崩溃 | doctor 全绿 | 打开 stderr + 对齐 ThrottleInterval 日志 |
| 发布后 CPU 飙高 | 插件预热标记 | 钉死插件 semver 并加冷却调度 |
可重复上线的七步行书
- 升级前备份 ~/.openclaw 与 launchd plist。
- 装好 Node 24+ 并与包前缀对齐。
- 用自动化 UNIX 账户执行 onboard --install-daemon。
- bootstrap LaunchAgent 并观测 PID 五分钟稳定。
- doctor 清零阻断项。
- 按探测指南打出合成 curl / Slack。
- 在运维 wiki 写明绝对路径给接管工程师。
SLO：租赁 Mac 守护进程 freshness
| 信号 | 阈值 | 动作 |
|---|---|---|
| 发布后 doctor 退步 | 存在任意致命项 | 冻结流量并 diff plist 重跑 onboard |
| stderr 丢失 | 出现无法解释重启即违规 | 修复 StandardErrorPath ACL |
| PATH 巡检 | 季度 >1% 主机漂移 | 重建黄金 AMI / Profile |
常见问题
| 问题 | 实务答复（2026-05-09） |
|---|---|
| pnpm store 放到外置卷？ | plist 导出 PNPM_STORE_DIR 并对 APFS 配额监控可行；高热网关慎用 NFS。 |
| 能否 sudo 安装？ | 建议专用自动化账号—sudo 常把 LaunchAgents 目录所有者搞乱。 |
Mac mini M4 裸金属与 OpenClaw 守护进程合拍的原因
Apple Silicon NVMe 尾延迟更稳，比挤在超卖的 VM 上更适合高频 websocket 扇入。选型参考 区域定价；PATH 玄学交 远程接入说明 逐项对照。
