三類常見痛點：看起來像「OpenClaw 壞了」
工單多是現象；背後常為路徑混用、升級未帶資料、跳過排查順序。
1）路徑不一。 指令碼、全域 npm、Compose 並存則設定與快取位置分歧，故障時難共識備份與啟動 unit。
2）無資料契約。 未遷狀態像全新安裝；無快照回滾恐遇 schema 不相容。資料目錄應為一等遷移面。
3）跳階梯。 應先行程／埠、閘道 HTTP、doctor、再最小重現日誌；勿未確認掛載就刪 node_modules。
記錄 Node、鎖檔或 digest、升級前 tarball 設定。
途徑選擇矩陣：試用筆電、團隊標準與正式主機
架構審查與事故皆可對照；OS 路徑不同，風險形態相近。
| 途徑 | 最適合 | 主要風險 | 最低控制面 |
|---|---|---|---|
| install.sh 精選流程 | 個人首次成功、示範、標準入門 | 版與版之間指令碼行為不透明 | 釘選 URL 或校驗值、記錄 stdout、快照設定目錄 |
| npm 或 pnpm CLI | 快速迭代、monorepo 工程師、CI 代理 | 全域／本機 CLI 混淆、Node 漂移 | Volta 或 fnm 釘 Node、非 root 服務帳號、repo 內鎖檔 |
| Docker Compose 堆疊 | 正式環境對等、可重複的埠與卷 | 掛載錯誤、映像標籤漂移 | 具名卷或綁定掛載附文件化擁有權、digest 釘選映像 |
難分高下時優先檔案邊界明確；勿把正式閘道與個人專案塞同一帳號。
install.sh：省什麼步驟、哪裡仍要靠紀律
指令碼收斂步驟，但 checksum、祕密不入歷程、Proxy 仍靠你；共用跳板注意 profile 副作用。
固定 SHA、留終端紀錄；完成後 openclaw doctor 並對 18789（或團隊埠）HTTP 探測。
常見：權限、SSL 攔截、執行使用者與 unit 使用者不一致。
npm 與 pnpm：釘 Node、全域 CLI 取捨與權限衛生
版本管理器釘 Node；pnpm 省碟，npm 較熟。專用 Unix 帳號跑閘道。
鏡像與逾時寫 runbook；which openclaw 後 doctor；禁全域則穩定 npx／腳本包裝。
Docker Compose：卷、埠、重啟策略與資源底線
YAML 固定映像與重啟；坑在掛卷與 UID。.env 當祕密輪替產物。
最小埠暴露，TLS 走反代；小節點約 1.5 GiB RAM 餘裕，unless-stopped 自愈。
容器內同樣 status→doctor→日誌；健康檢查與 LB 探針對齊。
範例排查順序（主機或容器內）
openclaw status
curl -sS -m 5 http://127.0.0.1:18789/health || echo "gateway probe failed"
openclaw doctor
openclaw health --json > /tmp/openclaw-health-$(date +%Y%m%d%H%M).json
openclaw logs --follow
若由反代對外終止 TLS，請改埠；邏輯順序維持「行程→閘道 HTTP→靜態驗證→執行期健康→敘事日誌」。
升級、回滾、排查順序，以及託管遠端 Mac 何時划算
升級前備份設定、環境、祕密庫通道權杖與昂貴快取； tarball 與舊 digest／鎖檔並存；測試環境驗 doctor／health 後低峰上線。
回滾即還原產物並用舊標籤／套件版重啟；有 schema 遷移先讀 release note。
事故：status→閘道 HTTP→doctor→日誌。
- npm ci 卡住： 鏡像、MTU、CPU 節流。
- doctor 乾淨通道無聲： bridge 與權杖。
- Compose 升級： diff 卷路徑。
小結： 三條路徑在速度、手感、可重現性間取捨；備份、釘 Node、排查契約化才優雅失敗。
限制： 睡眠本、帳號混用、無文件手改常先於打包問題。
SFTPMAC： 託管遠端 Mac 穩定供電、原生鏈，可與 SFTP／rsync 並置，減休眠與權限漂移。
兩天黑客松選哪條？
優先 install.sh 或文件化的 npm script，並在離場前快照設定。
受規範正式環境？
優先 Compose＋釘 digest、從金庫注入祕密、自動備份具名卷。
每次改環境都要重跑 doctor？
要；doctor 比無假設 tail 一小時便宜太多。
需要讓 OpenClaw 在託管 Mac 上與受管檔案同步流程並肩運行？比較 SFTPMAC 方案並在該環境基線化閘道。