谁会遇到问题：已按零散教程装好 npm i -g openclaw，却在 workspace、Gateway、通道、Skill 之间来回跳转，不知道官方推荐的 openclaw onboard 应如何一次走通，也不清楚 Node 24 基线、daemon 常驻与 stable/beta/dev 频道如何安全切换。本文结论：用doctor → onboard → 首通道验证 → ClawHub 安装首个 Skill → 安装 daemon → 记录频道升级与回退顺序的可复查 Runbook，把「能启动」升级为「能无人值守」。结构：六类痛点 → 路径对照表 → 六步实操 → 三 KPI → 选型收束；并与《官方 Docker 一键》《Compose 配对 1008》《doctor 入门排错》并联阅读。
2026 年上游仓库把 onboard 写成推荐入口，是因为 Gateway、workspace、通道与模型配置之间存在顺序依赖：跳过引导直接手改 JSON，常见症状是「进程在、消息不进」或「Skill 装了但工具从未注册」。下面六条是社区里最高频的误判。
openclaw doctor：把风险堆到 onboard 末尾才暴露，排障无法二分；doctor 应作为门禁而非装饰。若你明确要走容器拓扑，请以《docker-setup.sh 与 GHCR》为主、本文为辅助；若你卡在子代理 pairing，请优先阅读《Compose 1008 与 trustedProxies》，不要在未理解网络命名空间前反复重装 npm 包。
| 路径 | 适用场景 | 你应带走的关键产物 | 与本文关系 |
|---|---|---|---|
openclaw onboard（npm 全局） | 本机或远程独占 Mac 上常驻 Gateway | workspace、openclaw.json、launchd/systemd unit、首通道与 Skill 验证记录 | 主路径 |
| 官方 Docker / Compose | 需要镜像交付、团队统一运行面 | Compose 文件、卷映射、OPENCLAW_IMAGE 切换策略 | 互补；见 Docker 专文 |
| 仅 doctor 排错 | 已装但健康检查不过 | 症状树与日志指纹 | 并联《doctor 入门》 |
注意：onboard 会写入用户目录下的配置与 workspace；在多人共用的 macOS 账户上运行前，先确认是否违反团队安全基线。生产环境更推荐独占主机或服务账户。
node -v 写入变更单。npm i -g openclaw@latest 后立刻 openclaw doctor，对高风险项清零后再进入 onboard。openclaw onboard：按向导完成 workspace、默认模型、AGENTS.md 注入与至少一条通道；保存向导输出的 Gateway 端口与控制 UI 路径备忘。openclaw skills search → openclaw skills install <name> → 重启 Gateway → openclaw skills list 确认加载。openclaw onboard --install-daemon（或向导等价选项）；配置日志轮转与磁盘水位观察点，再评估是否需要 openclaw update --channel beta|dev 的预发布窗口。# 1) 基线与 CLI node -v npm i -g openclaw@latest openclaw doctor # 2) 引导（交互） openclaw onboard # 3) Skill 示例（名称请替换为搜索到的真实包） openclaw skills search "calendar" openclaw skills install example-org/some-skill openclaw restart # 或等价命令：确保 Gateway 重新加载 Skills openclaw skills list # 4) 常驻（按向导提示选择 launchd / systemd） openclaw onboard --install-daemon # 5) 频道升级（写入变更单后再执行） openclaw update --channel stable # openclaw update --channel beta # openclaw update --channel dev
v24.x + nvm 或官方 pkg；升级 OS 后强制复跑 doctor。127.0.0.1 与反代/Tailscale 等拓扑决策，避免与《Compose 配对》中的 bind 讨论冲突。stable|beta|dev 与团队变更窗一一对应；回退时必须同时记录 CLI 与 Gateway 版本号对。上述参数为工程审计字段，不是供应商合同字段；请与内部变更管理对齐。若你在远程独占 Mac 上同时跑 CI 与 Gateway，应为两者划分CPU 与磁盘水位告警，避免构建峰值把日志与 SQLite 状态饿死。
从架构视角看，onboard 的价值在于把「引导问题」收敛成可重复脚本：workspace 与 Skills 目录一旦确定，后续自动化（备份、监控、升级）才有锚点。若跳过该锚点，团队往往会在「谁改了哪份 openclaw.json」上浪费大量会议时间。
笔记本睡眠、VPN 抖动与企业策略更新会破坏 Gateway 的时间连续性；当 OpenClaw 作为小型团队的事实中控时，更稳妥的是把常驻实例放到可 7×24 运行、磁盘与出口可预测的环境。若仍需本地笔记本参与开发，可把其定位为「CLI 客户端」而非「唯一 Gateway 宿主」。
自建家用或办公室机器常面临电力、网络与系统补丁窗口不可控；而需要把 AI Agent 与 iOS/CI 工作流同区部署时，使用带六国可选区位的 Apple Silicon 云主机作为常驻底座，通常比临时借用设备更易写进 SLA。MACCOME 提供多地区裸金属节点与弹性租期，适合承载「Gateway 常驻 + 构建机」分层；公开价格见 租赁价格说明，排障与通道问题可参考 帮助中心。
落地建议：先在独占远程 Mac 上跑通 onboard + daemon 一周并收集日志体积与峰值 CPU，再决定是否把 beta 频道预发布接入同一台机器，而不是在首周就把个人开发机与生产 Gateway 绑在一起。
常见问题
WSL2 上也能照抄 macOS 的 onboard 步骤吗？
大方向一致，但网络与路径有差异；请以《doctor 与 WSL2 分平台排错》对照，不要假设 Windows 与 macOS 的 systemd/launchd 行为相同。
Skill 安装后列表为空怎么办？
优先确认 Gateway 是否已重启、安装路径是否在 workspace 可见范围，并对照官方 Troubleshooting 与《Gateway 无回复与模型错误》分症状，而不是立刻切换 beta 频道。
与 Docker 官方一键路径冲突吗？
不冲突但不要混用同一数据目录；容器轨与 npm 轨应二选一并写进团队规范。详见《docker-setup 与 GHCR》。