openclaw@2026.5.x，先滿足2026.5.x 文件的 Node 24 基線，並把回滾檢查點例行化。curl … install.sh 與 npm install -g 擇一（勿未解除舊版就疊兩路），onboard 與長跑機 --install-daemon，串 gateway status（可加 --json）、doctor、讀懂 config validate 結構化輸出。權杖與暴露面見閘道權杖與探針；純門禁見設定驗證 CI 門禁。
為何 MacPull 高頻拉取／CI 要在意閘道穩定
MacPull 場景常見高頻 git pull、registry／鏡像與多流水線並行。閘道若抖動，預檢、Webhook 與依賴預拉取（npm、Pods、映像層等）便失去穩定控制面，難以對照「合併前是否曾綠燈」。
釘2026.5.x於 Node 24，把 config validate 與 doctor 收進單一可重播腳本並上傳工件，閘道即可與其他建置依賴一樣假設為已知良好。延伸：status／doctor 門禁、CI 預拉一致。
Node 24 門檻（對齊 2026.5.x 文件）
2026.5.x 上游說明將閘道支援安裝的引擎基線放在 Node 24。請在 bootstrap 與 CI 的第一行就印出 node -v，並在重開機後仍由 launchd 載入的同一主體再印一次，確認 major 一致；僅在互動式 SSH 看到 24、plist 內卻仍指向舊 node 是最常見的「手動綠燈、自動紅燈」來源。
建議匯出 OPENCLAW_HOME、OPENCLAW_CONFIG_HOME，目錄 chmod 700，並把 npm 全域 bin 或 openclaw 絕對路徑寫進 plist 的 PATH；細節與上線驗收串聯見安裝／doctor／閘道驗收清單。
安裝二選一：curl install.sh 或 npm 全域（勿混用）
Golden image 上應只存在一條發行故事：要嘛走上游文件中的官方一行程式，要嘛走團隊已審批的 npm install -g semver；在未解除／解除衝突前，不要讓兩個 openclaw 二進位搶 PATH 優先權。
| 路徑 | 適合情境 | 釘版紀律 |
|---|---|---|
官方 curl -fsSL …/install.sh | bash |
新機或對照文件逐步複製（實際 URL 與旗標請以當下 docs.openclaw.ai 為準；下列為常見範式）。 | 安裝後立刻 openclaw --version，必須落在 2026.5.x；否則先停機查詢而非改設定。 |
npm install -g "openclaw@^2026.5.0" |
已有內部 npm 鏡像、變更委員會與全域 bin 稽核流程。 | 同步列印 command -v openclaw 並把路徑寫進建置日誌工件，避免與 Homebrew／其他全域套件撞名。 |
官方一行程式常見寫法如下（若上游更新位址或參數，請改貼文件原句）：
curl -fsSL https://openclaw.ai/install.sh | bash openclaw --version
onboard 與守護（--install-daemon）
以實際承載流量的服務帳號執行 openclaw onboard；非互動旗標與環境合併請對照環境變數合併 CI 門禁。長跑遠端 Mac 再執行 openclaw onboard --install-daemon 註冊 launchd；短生命週期 PR Runner 通常應略過常駐閘道，以免並行 job 爭搶預設埠 18789。
維護窗內可安排一次重開機驗收：重登入後再跑 openclaw gateway status --json、openclaw doctor 與（若已啟用鑑權）帶 Authorization: Bearer 的本機 /health 探針，確認 plist 內 OPENCLAW_CONFIG_HOME 與 SSH 工作階段一致。
gateway status 與 doctor：何謂綠燈
openclaw gateway status（建議加 --json 供儀表板與門禁解析）回答「閘道此刻自認對外宣告了什麼」；openclaw doctor 則回答「檔案系統、引擎與環境是否健全」。兩者有交集但不可互換，請在同一條 && 鏈執行並上傳 stdout／stderr 工件。
若你正在調整 Skills 封裝，請併讀Skills 回滾與 doctor；本文聚焦 semver／Node 24／validate／檢查點。
#!/usr/bin/env bash set -euo pipefail node -v command -v openclaw openclaw --version openclaw gateway status --json openclaw doctor
config validate：結構化輸出怎麼讀
對守護行程實際讀取的檔案執行 openclaw config validate --config "${OPENCLAW_CONFIG_HOME}/openclaw.json"（路徑依部署調整）。若 CLI 提供機器可讀／JSON 類旗標，請以 openclaw config validate --help 在已釘選的 minor上確認確切名稱。輸出可粗分三層理解：
- 整體通過與離開碼：CI 應 fail-closed，非零即失敗，即使人眼看起來「只有警告」。
- 已通過 schema 的區塊：用於變更前後 diff，避免誤刪仍有效的片段。
issues／invalid-key等項目：逐筆對照其 JSON pointer 或點分路徑 開啟openclaw.json該巢狀節點修正，而非只讀純文字 stderr 猜測。深入門禁範例見設定驗證 CI 門禁。
openclaw doctor && \
openclaw config validate --config "${OPENCLAW_CONFIG_HOME}/openclaw.json"
回滾檢查點（最小可複現）
在變更監聽、providers 或 auth 區塊前，為設定目錄建立帶時間戳與主機名的 tarball，並寫入校驗和；敏感內容進共享工件庫前請依資安政策脫敏或加密。
CK="openclaw-checkpoint-$(date -u +%Y%m%dT%H%M%SZ)-${HOSTNAME:-mac}"
tar -czf "${CK}.tgz" -C "${OPENCLAW_CONFIG_HOME}" openclaw.json
shasum -a 256 "${CK}.tgz" | tee "${CK}.tgz.sha256"
還原演練（建議每季在測試遠端 Mac 做一次）：launchctl unload OpenClaw 標籤 → 將 tarball 解回 OPENCLAW_CONFIG_HOME → 若連 semver 一併升級過，必要時以記錄在工單上的前一 patch 範圍重裝 npm → launchctl load → 重跑 gateway status、doctor、config validate 與 Bearer 健康探針。還原若在數分鐘內完成，週五傍晚誤發模型路由時 on-call 會輕鬆許多。
長跑遠端 Mac：可列印最短鏈
- 證明 Node 24，匯出
OPENCLAW_HOME／OPENCLAW_CONFIG_HOME。 - 以 curl install.sh 或
npm install -g "openclaw@^2026.5.0"擇一安裝；列印openclaw --version。 - 將
openclaw.json打成.tgz並寫校驗和。 openclaw onboard，長跑機再openclaw onboard --install-daemon。- 依序
openclaw gateway status --json、openclaw doctor、openclaw config validate --config …，最後跑鑑權健康探針。
FAQ
昨天 Node 22 還能跑，一定要升 24 嗎？
對 2026.5.x 請以文件中的 Node 24 為準做 golden image；留在 22 可能遇到難以重現的引擎邊角負載問題，且與上游支援敘述不一致。
curl 與 npm -g 哪個「更正統」？
兩者皆為上游支援路徑；依 fleet 政策擇一，並在每個流水線工件寫死 openclaw --version 與 command -v。
CI 只跑 config validate 可以嗎？
可以當門禁，但實際跑閘道的主機仍應保留 doctor，以捕捉權限、PATH、目錄權限等 validate schema 看不到的問題。
權杖與非迴環暴露面？
請讀OPENCLAW_GATEWAY_TOKEN 與探針與官方閘道安全章節；本文不複述祕文內容。