OPENCLAW_GATEWAY_TOKEN → onboard --install-daemon 讓 launchd 扛長跑 → 依序跑 openclaw doctor、openclaw config validate、openclaw gateway status --json，最後以帶 Authorization: Bearer 的 curl 打 /health。延伸：閘道權杖與探針、status／doctor 門禁、回滾與 doctor。
Node 22+ 前置
對齊上游：使用 Node 22.14 LTS 或 Node 24。遠端 Mac 上 CI 與 launchd 必須共用固定前綴（例如 /usr/local/bin），並在 plist／job 內顯式寫入 PATH；勿假設互動式 ~/.zshrc 已載入 nvm。每個驗收段落開頭記錄 node -v 與 openclaw --version， semver 升級才有對照。
安裝路徑選擇：官方 install 與 npm 全域
路徑 A：依 docs.openclaw.ai 的 Installer（常見為 curl 一行程式）— 適合要與文件完全一致、由安裝器處理依賴的場景。路徑 B：npm install -g "openclaw@^…" 釘團隊核准的 semver。兩條路徑後都執行 command -v openclaw 與 openclaw --version；若 Homebrew 補鏈失敗，請改看站內環境合併專文，不在此杜撰額外子指令。
迴環閘道、埠 18789 與令牌
2026 年閘道文件以本機綁定 127.0.0.1 與預設埠 18789 為基線。請以祕文庫注入 OPENCLAW_GATEWAY_TOKEN（語意可比 Kubernetes SecretRef），並避免尾隨換行。上線前用 curl 對 http://127.0.0.1:18789/health 帶 Authorization: Bearer …：應得 2xx；拿掉標頭應為 401，才表示鑑權鏈與探針一致。若要擴監聽到區網，務必先讀官方暴露面與 TLS章節，本文不展開非迴環細節。
export OPENCLAW_GATEWAY_TOKEN="$(cat "$RUNNER_TEMP/gw.token")"
openclaw doctor
openclaw config validate --config "$OPENCLAW_CONFIG_HOME/openclaw.json"
openclaw gateway status --json
curl -fsS -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $OPENCLAW_GATEWAY_TOKEN" \
"http://127.0.0.1:18789/health"
守護行程與開機自啟驗證
長跑請用官方引導的 onboard --install-daemon（或等價 plist）註冊 launchd；變更環境後執行 launchctl unload／load 重載標籤。開機自啟驗收：登出再登入同一使用者，確認 openclaw gateway status --json 仍顯示預期監聽與版本；必要時以 log show 對照守護 stderr。可選前景驗收請僅使用文件與 openclaw gateway --help 列出的旗標（例如部分版本提供 gateway run --headless），勿臆造未列出的子命令。
常見報錯指紋與回滾
| 指紋／現象 | 高機率原因 | 回滾或處置 |
|---|---|---|
EADDRINUSE 於 18789 | 殘留行程或其他服務佔埠 | lsof -nP -iTCP:18789 -sTCP:LISTEN 歸檔 PID；停止非預期行程後重載 plist |
| 互動 shell 正常、守護仍 401 | plist 未帶新權杖 | 比對 EnvironmentVariables；單輪 unload／load |
config validate 印 invalid-key | 設定與 schema 漂移 | 還原備份 openclaw.json；再跑 validate |
command not found: openclaw | non-interactive PATH | 寫死 PATH／全域 bin；附 which openclaw 工件 |
大範圍回滾：launchctl unload 標籤 → 還原設定目錄備份 → 必要時 npm uninstall -g openclaw；細部技能與 doctor 節奏見站內 回滾專文。
列印用步驟清單
- Node 與
openclaw版本已記錄；PATH 與 plist 一致。 doctor→config validate→gateway status --json已依序綠色或已歸檔 stderr。- Bearer
curl對127.0.0.1:18789/health為 2xx；無標頭為 401。 - 18789 埠指紋（PID／命令列）與基線一致或變更已註記。
FAQ
上線驗收時一定要先跑哪幾個指令？
建議 openclaw doctor → openclaw config validate → openclaw gateway status --json，再以 Bearer curl 驗 /health；順序與站內 status／doctor 門禁一致，先清設定再讀執行期狀態。
為何強調 127.0.0.1 與埠 18789？
與 2026 年官方閘道敘述對齊：預設本機綁定降低暴露面；狀態 JSON 與 HTTP 探針應互相印證同一監聽端點。
non-interactive shell 找不到 openclaw 怎麼辦？
在 CI 與 plist 寫死 PATH 與 npm 全域 bin，並以絕對路徑呼叫 CLI；詳見 權杖與 PATH 專文。
總結：遠端 Mac 上線 OpenClaw，請把安裝路徑（install 或 npm -g）、127.0.0.1:18789、OPENCLAW_GATEWAY_TOKEN、launchd 與 doctor／validate／status／Bearer 探針串成一條可稽核鏈；失敗時依指紋表回滾 plist 與設定備份。需要固定節點跑門禁與預拉取，可到 定價、購買遠端 Mac、說明中心 與 首頁了解方案；更多場景見 技術部落格 OpenClaw 標籤文。