2026年 OpenClaw v2026.5.x
五地遠端 Mac：前綴安裝、doctor／sharp 排障與 Gateway SSH 值班流

一安裝腳本與前綴：v2026.5.x 的雙入口

v2026.5.x 將安裝拆成兩個入口：install.sh 是黃金鏡像的一鍵全量，install-cli.sh 只裝增量 CLI，便於 CI 鏡像層快取。新版預設將全域套件落到使用者目錄前綴（如 ~/.openclaw 與 ~/.npm-global），徹底杜絕 sudo npm 與系統路徑漂移。安裝完成務必記錄三條基線：which openclaw、node -v、openclaw --version，作為日後排障的對照值。CI 與本機節點請寫死同一前綴與 PATH，避免 npm_config_prefix 在不同 shell 之間互踩。

二五地節點與 SSH 隧道角色

✓ 表示該列表現側重。Compose 隔離與裸機雙路徑可搭配 v2026.3.22 後的 Compose 隔離指南一併閱讀。

Node 24 與 22.14 雙基線

Node 雙基線二選一：嚐鮮選 24，求穩釘 22.14。CI、launchd、cron 與本機 shell 必須用同一條 Node，否則會出現「CLI 已升級但 sharp 仍是舊原生模組」的混編現象。換版時請全量重裝、重啟 launchd，並跑一次 openclaw doctor。PATH 與 npm_config_prefix 在 ~/.zprofile 與 cron 環境同源，是減少漂移的根本。

三doctor 與 sharp 排障門禁

openclaw doctor 是合併與發版的閘門：依序檢查網路與證書、磁碟與監聽埠、本機配置與權限。任何紅燈先停線。sharp 報錯多由 Node 改版觸發：對齊 Node 後，刪除 node_modules，再 npm rebuild sharp --build-from-source。注意 Apple Silicon 必須在 arm64 程序下重編，混 Rosetta 是常見坑。三段全綠之後再動 launchd 重新拉起服務，並把這條順序貼進團隊 Runbook。

四三角色值班 checklist

• 客服值班：以「只讀＋doctor」為主，建立 ssh -R 模板、登記轉發埠，事故 30 秒可回放現場。
• PR 守門：合併前必貼 Node 版本、doctor 摘要與是否含原生模組變更（特別標 sharp）；缺一禁併。
• 發版值班：發版視窗凍結 prefix 與 Node 版本，灰度推單點；回滾步驟與 Runbook 同頁可見。

機型與磁碟的分工

低配 M4 16GB／256 適合純客服與只讀 doctor；M4 Pro+1TB 用作 PR 守門的 sharp 編譯與日誌快取；M4 Pro+2TB 則扛合規歸檔與發版並行。一般優先順序：盤警先擴 1TB／2TB，盤滿再評估升 Pro，避免「盤滿 → 升 Pro」順序倒置。詳細帳本可內鏈到 Gateway／Skills／doctor 與儲存擴容指南。

五角色矩陣：低配 vs M4 Pro＋盤

事先固定責任邊界，可避免值班搶改前綴與 Node。低配機只讀記錄，Pro 機承接 rebuild 與發版隧道，事故升級條件以排隊深度、sharp 狀態與盤位為準。

六在 Mac mini 上，這一切更簡單

macOS 把 Node、原生模組與 launchd 收進同一權限模型：Gatekeeper 與 SIP 大幅降低「環境被誰改過」的爭議；Apple Silicon 統一記憶體讓 Gateway 與 doctor 同時掃描時，仍能從容完成 sharp 重編。M4／M4 Pro 待機僅約 4W、無風扇靜音，特別適合 7×24 隧道與發版窗。

若要讓五地雲機與本地桌機腳本一致，用 Mac mini M4 做「黃金對照機」，可顯著壓低前綴漂移與 sharp 誤編——現在即可入手 Mac mini M4，把 Runbook 對齊後再上雲，五地隧道與值班節奏即刻收斂。