1. 痛點：誰常駐、誰監聽、日誌在哪
常見三類：前置不清（Node 版本、套件管理、設定路徑）導致精靈報錯難讀；行程模型誤解（以前景附著執行，關閉視窗即停）；觀測不足（埠號衝突、反向代理、系統休眠）變成反复重裝。以下依「前置 → 精靈 → 常駐 → 驗證 → 排錯 → 遠端託管」拆解。
2. 安裝前置
| 檢查 | 建議 | 後果 |
|---|---|---|
| Node | 對齊官方/文件建議版本 | 原生模組或 CLI 不相容 |
| 套件管理 | 專案內固定 npm/pnpm/yarn | lockfile 漂移 |
| 設定路徑 | 確認使用者目錄下實際讀取的檔案 | 改錯檔、設定不生效 |
| API 金鑰 | 最小權限、分環境保存 | 費用與外洩 |
3. onboard 精靈在做什麼
可視為綁定身分（金鑰）、通道、執行方式（手動/守護）與工作區。失敗時先保留完整錯誤與步驟編號，勿先清空設定。
4. Gateway：前景 vs 守護程序
前景適合首次打通；守護程序適合長時連線，但須確認執行使用者、工作目錄與環境變數與互動式 shell 一致。
5. 五步最小驗證
健康檢查或監聽 → 最小訊息往返 → 日誌關鍵字 → 若有代理則 TLS/WebSocket → 記錄版本與一次成功請求 ID。
6. 埠號與日誌對照
| 現象 | 先查 | 處理 |
|---|---|---|
| 埠號已被占用 | lsof / 系統工具 | 結束殭屍行程或改埠 |
| 守護程序秒退 | 服務日誌、WorkingDirectory | 改以前景復現 |
| 通道無回應 | Webhook、防火牆 | 本機與外網各測 |
| 間歇斷線 | 休眠、上游限流 | 遠端關閉休眠、加重試 |
lsof -iTCP:PORT -sTCP:LISTEN
參考：
- 日誌至少保留連續數十行再搜尋關鍵字。
- 小版本升級前後各做一次健康檢查＋一則端到端訊息。
- 遠端 Mac 注意系統碟剩餘空間與日誌輪替。
7. 遠端 Mac 長期託管
休眠策略、更新後守護程序是否自動拉起、日誌輪替、多使用者下服務帳號是否正確，應寫成簡短 Runbook。
8. 可複現啟動路徑的價值
Agent 網關迭代快，事故模式卻重複：設定漂移、雙實例、環境不一致。將精靈輸出與健康檢查命令版本化，可在分鐘級回到已知良好狀態。與本機剪輯/GPU 任務並行時，將 OpenClaw 放在資源邊界清楚的遠端 Mac 更穩。
若本機常斷線或埠號衝突，可將 OpenClaw 放到 MACGPU 遠端 Mac，按使用時長計費先驗證再決定長期資源。