讀者：您已用零散筆記安裝 npm i -g openclaw，卻在工作區、Gateway、通道與 Skills之間來回，沒有依上游建議走完整openclaw onboard流程，也搞不懂Node 24、常駐程式，以及 stable／beta／dev 更新通道應如何一併演進。產出： 可審查的 Runbook—doctor → onboard → 首條通道驗證 → 首個 ClawHub Skill → 常駐程式安裝 → 有紀錄的升級與回滾，把「偶爾能啟動」變成「可無人值守穩定運行」。地圖： 六個誤解 → 路徑表 → 六步驟 → 三個變更單審計欄位；併讀 docker-setup＋GHCR、Compose pairing 1008 與 安裝後 doctor。
上游推 onboard，因為 Gateway、工作區、通道與預設模型之間存在順序依賴。略過精靈、手改 JSON，常落到「程序在跑、訊息永遠不來」或「Skill 顯示已裝、工具卻從不註冊」。以下彙整 2026 社群討論中六個常見誤讀。
openclaw doctor： onboard 收尾時被卡住卻沒有二分脈絡；應把 doctor 當關口，非裝飾。若您以容器為主，請以 docker-setup＋GHCR 為主、本文為輔。若卡在子代理配對，請在盲目重裝 npm 前先看 Compose 1008。
從變更管理角度，建議同一發佈週內，把 openclaw CLI、Gateway、Skills 的日誌首行一併貼在變更單上；每週檢討時可立刻追到「實驗版是否誤上正式入口」。欄位很小，卻能省下大量週一救火時間。若內部還有舊的 macOS 快取掛載在 NFS 上，也請在變更單欄外註明：本輪變更是否觸及該掛載；NFS 逾時常與 Gateway 看起來「凍住」同時出現，先排除儲存面再改模型參數可省很多無謂比對。另請同步記錄當週系統日誌中是否有磁碟 I/O 等待尖峰，與 openclaw 的寫入是否落在同一分鐘。
此外，兩套以上反向代理實驗在平行環境測試時，請在 DNS／憑證與 SNI 三處用同一本對照表；多數「偶爾 502、偶爾成功」是憑證名與實際連線主機名不一致，而不是 openclaw 本體損毀。把三處寫成表，一線同仁能在五分鐘內判斷要回到本稿的通道表，還是回到 Nginx 篇的安全段落。若同時跑本機模擬器與遠端構建，請在週報加註當週是否啟用硬體加速與熱節流閾值，避免把溫度保護誤判成網路問題。
| 路徑 | 最適用情境 | 應留存的產出 | 與本文的關係 |
|---|---|---|---|
openclaw onboard（npm 全域） | 需要長期 Gateway 的專用 Mac 或 VPS | 工作區、openclaw.json、launchd／systemd 單位、通道驗證、Skill 驗證日誌 | 主線 |
| 官方 Docker／Compose | 以映像交付、要一致執行環境 | Compose 檔、卷映射、OPENCLAW_IMAGE 切換策略 | 互補 |
| 以 doctor 為主的切分 | 已安裝但不健康 | 症狀樹、日誌特徵 | 平行閱讀 |
警告： onboard 會寫入使用者家目錄。在共享 macOS 帳戶上請先取得政策；正式環境宜採專用主機或服務帳戶。
node -v。npm i -g openclaw@latest 後執行 openclaw doctor；onboard 前處理高風險項。openclaw onboard： 完成工作區、預設模型、AGENTS.md 寫入，以及至少一條通道；自精靈輸出抄錄 Gateway 埠與 Control UI 路徑。openclaw skills search → openclaw skills install <name> → 重啟 Gateway → openclaw skills list。openclaw onboard --install-daemon（或精靈等效步驟）。在嘗試 openclaw update --channel beta|dev 前，先上日誌輪轉與磁碟水位監控。node -v npm i -g openclaw@latest openclaw doctor openclaw onboard openclaw skills search "calendar" openclaw skills install example-org/some-skill openclaw restart openclaw skills list openclaw onboard --install-daemon openclaw update --channel stable
v24.x；每次作業系統升級後重跑 doctor。stable|beta|dev 對應到行事曆窗口；回滾時一併記錄 CLI 與 Gateway 版本成對關係。上列為工程審計用欄位，非廠商 SLA。若 Gateway 與 CI 同機，請加 CPU 與磁碟告警，避免建置作業把日誌或 SQLite 狀態餓死。若團隊同時接多個雲端模型與地端模型，建議在週報固定一欄「本週啟用端點與資料外送邊界」，避免只換通道卻在帳單與法遵兩邊同時失火。
架構上，onboard 是自動化錨點：工作區與 Skills 目錄一旦固定，備份與升級就只剩單一真實來源；跳過錨點，會議便耗在「誰改了哪份 openclaw.json」。
若團隊在企業內網內以 mDNS 服務名互相發現，建議在變更單多附一欄：當週 dns-sd -B 掃到與本機衝突的服務名，以及預定綁定的 IP／介面。此欄常與「週一早上全員斷線」出現在同一段期間，可與補丁週一併寫進維保表。附註：若同網段有多臺同名測試機，請一併列出序號尾碼以免誤操作。
睡眠、VPN 抖動、企業補丁政策會破壞 Gateway 的時間連續性。當 OpenClaw 成為小團隊實際上的控制面，宜優先採用具可預測磁碟與出口的長時主機，筆電僅作 CLI 客戶端即可。
住家與辦公塔式機也面臨難以預測的更新與電力窗口。當要與 iOS 構建叢集並行承載 AI 代理時，跨區域、可稽核的 Apple Silicon 雲主機，往往比借用筆電更容易收斂營運指標。MACCOME 提供裸金屬節點與彈性租期，可先參考租賃價格說明與幫助中心的連線與帳戶說明。
建議先以專用遠端 Mac 跑一週 onboard 加常駐程式，量測日誌量與 CPU 尖峰，再決定測試通道是否與生產同機；避免第一週就把正式 Gateway 綁在個人開發機上。
上正式環境前，建議在同一臺主機上再跑一次 openclaw doctor，把輸出首段與（若您環境有）Gateway 健康檢查位址的 HTTP 狀態一併貼到變更單。這能讓上線檢討的螢幕分享更快收斂。若短期內需要測試版 CLI 與穩定版 Gateway併行，也請在團隊規範寫明「每週合流回單一通道對照表」，避免週一早上才發現兩週沒人對表。作業系統大版本或安全更新後，最容易先爆的是日誌把磁碟打滿，因此除 openclaw 狀態目錄外，系統層日誌與臨時目錄也建議一併設水位。上述屬內部工程實踐，非上游服務層級承諾。若工作區內容含個人資料或受規範的憑證，請在設計日誌保留與稽核週期時，先與資安／法遵窗口對齊，而非僅依工具預設值。月維可再加查：遠端桌面或 SSH 隧道逾時、以及反向代理的 TLS 憑證剩餘天數，兩者往往與「Gateway 週一早上集體掉線」同時出現，可一併排程處理。
從併發觀測角度，團隊若同時跑多個遠端節點，可在變更單模板固定三欄：本機 node -v、openclaw CLI 以 --version（或文件指定旗標）取得的字串、Gateway 行程啟動時間戳。三欄一致時，週期性「神秘斷線」有很高比例是通道漂移，而非雲廠商線路。把這些欄位變成表單必填，能讓一線值班的猜測時間縮到最短。若還要自動備份工作區，請在表單加第四欄：秘鑰目錄與聊天匯出目錄是否分桶、分金鑰寫入，避免兩者誤併導致合規審核爆雷。
筆記型電腦若與 CI 混用同一臺，建議每週在變更摘要加註兩行：openclaw 工作目錄樹狀大小估計、與本機 DerivedData 的合計體積。兩行都在預期內的話，月底磁碟用罄多半是排程，而不是「突然變慢」。每季可再把使用者家目錄內 openclaw 相關路徑與聊天匯出保留策略一起檢查，讓臨時清檔的消防演練變成可預期的維保窗口。若內容含敏感個資，刪除與留存時程要先取得法遵簽核，再改工具參數。遠端桌面同時工作階段數、反代上 TLS 憑證剩餘天數、本機 mDNS 衝突與企業補丁週，建議併到同一週曆，常與「週一早上 Gateway 集體連不上」出現在同一段時間窗，可一併巡檢。
常見問題
WSL2 的步驟與 macOS 相同嗎？
大方向相同，路徑與網絡不同。請依 doctor＋WSL2 分診處理，不要假設與 launchd 對等。
安裝後 Skills 清單仍空，先處理什麼？
先確認已重啟 Gateway 與工作區可見性，再讀 Gateway 無回覆分診，最後再考慮測試通道。若還要核對帳戶與接入手續，可同步開啟 幫助中心。
與 Docker 安裝是否衝突？
不衝突，但勿共享同一資料目錄；依政策採 npm 或容器單一主線，並參考 docker-setup＋GHCR 的前提。