远程 Mac首装 OpenClaw 常遇装得上验不过：PATH 与 launchd 不一致、一八七八九被占、缺令牌致探针异常。本文给 install.sh 与 npm 全局二选一、回环与
OPENCLAW_GATEWAY_TOKEN、onboard 自启核对，并串 config validate、doctor、gateway status 与 curl /health。延展 网关令牌、status 门禁、配置校验；首页、购买免登录。💻🚀
痛点拆解
其一shell 可用而 LaunchAgent 找不到解释器，多因 nvm PATH未进 plist。其二一八七八九被旧实例占住出现 address already in use。其三扩到非回环却未先设令牌，进程可能拒绝启动，见 docs.openclaw.ai/cli Gateway 安全说明。
Node 22+ 前置
- 确认
node -v主版本不低于 22，与团队钉版一致。 - plist 与手工验收使用同一绝对路径的
node，例如 Homebrew 或/usr/local/bin/node。 - 预检日志写入
which node、node -p process.execPath，便于与 CI 对照。
安装路径选择
团队只保留一种入口：官方一键适合快速对齐发行版；npm 全局钉版适合锁 semver。装完立刻 which openclaw 与 openclaw --version 写入验收附件。
| 路径 | 适合 | 注意 |
|---|---|---|
| curl install.sh | 首装与内网镜像策略允许时 | 组织禁管道则先落盘审计再执行 |
| npm install -g openclaw@钉版 | 多机版本一致与回滚清晰 | 核对全局前缀与 launchd PATH 同源 |
# 官方一键（示例，策略允许时使用）
curl -fsSL https://openclaw.ai/install.sh | bash
# 或 npm 全局钉版
npm install -g openclaw@钉版
which openclaw
openclaw --version
本机回环网关、端口 18789 与令牌
对齐网关文档：默认一八七八九、本机绑定先验收；openclaw gateway status --format json 看监听与就绪。Bearer 场景导出 OPENCLAW_GATEWAY_TOKEN 后 curl http://127.0.0.1:18789/health 作状态探针。扩非回环前读 令牌专文。
守护进程与开机自启验证
- 执行
openclaw onboard --install-daemon，记录 LaunchAgent Label。 - 在 plist
EnvironmentVariables或包装脚本中写入令牌与OPENCLAW_HOME，权限与运行用户一致。 - 重启主机后再次
lsof -nP -iTCP:18789 -sTCP:LISTEN，确认监听进程与期望命令行匹配。
上线验收串联步骤
顺序：validate→doctor→gateway status --format json→lsof 指纹→curl /health。钉版若支持 --strict 可打开校验。
openclaw config validate --strict 2>&1 | tee validate.log
openclaw doctor
openclaw gateway status --format json > gateway-status.json
lsof -nP -iTCP:18789 -sTCP:LISTEN > port-18789.txt || true
curl -fsS -H "Authorization: Bearer ${OPENCLAW_GATEWAY_TOKEN}" "http://127.0.0.1:18789/health" || true
流水线对齐见 status 门禁文。
Meta（站内）：
2026-openclaw-remote-mac-install-gateway-doctor-checklist.html；一八七八九、回环、status 与 /health；内链令牌、status 门禁、配置校验三文。
常见报错指纹与回滚
| 现象或指纹 | 回滚与修复顺序 |
|---|---|
| 端口占用 且 lsof 非本团队二进制 | 维护窗停止冲突进程或调整端口；卸载守护后重装钉版 CLI |
| 拒绝连接 或 status 超时 | 查 plist 是否指错 Node；sleep 二四八秒有界退避后重试 |
| 无鉴权或令牌相关启动失败日志 | 先恢复仅回环与令牌注入，再扩绑定；对照官方 FAQ |
可引用要点
- 验收日志固定包含 版本号、监听地址与 一八七八九指纹一行。
- 配置树变更前后各跑一次 validate，diff 附在合并说明。
- 回滚默认动作：停守护→还原配置→重装钉版→doctor 绿灯再开流量。
FAQ
只做本机回环验收还要准备网关令牌吗？
依官方 Gateway 说明；Bearer 探针需在 plist 与线上一致导出变量；扩非回环前读 令牌专文。
install.sh 与 npm 全局可以混用吗？
不建议。钉死一种安装源并在 which openclaw 只保留一条路径，避免 launchd 与交互会话各跑各的二进制。
上线失败如何最小回滚？
卸载或停用 LaunchAgent、恢复上一版配置、按钉版重装包后再跑 doctor 与 gateway status，确认端口指纹回到期望进程。