在 Mac mini M4 上新裝的 OpenClaw 常因 launchd 未印錯誤而「看似綠燈」——權杖一輪替 webhook 就開始抖動。此 2026 矩陣將安裝後驗證化為兩張表：具明確通過線的決定性 冒煙檢查，以及告訴維運是否該信任 openclaw doctor、重讀安裝文件或升級至就緒 SLO 工作的 症狀路由。
以 完整 macOS 安裝與部署 定錨儀式，以 doctor 驅動的健康修復 對齊診斷，以 健康與就緒 SLO 指引 拆分探針，並以 無頭上線與守護行程驗收 完成驗收。
為何「沒有當機日誌」不算冒煙測試
Apple Silicon 上的閘道與背景索引及 CI 殘留共用統一記憶體。錯使用者、過期權杖檔，或管理通訊端綁到非預期介面的靜默半失敗，可能直到第一則已簽章 webhook 抵達才爆發。因此冒煙必須同時斷言 身分、版本 與 網路姿態，而非僅行程存活。
- 版本漂移： 在重新載入 launchd 前，
openclaw --version必須與票據上的語意版本一致。 - Doctor 假綠燈： 檢查通過但
openclaw gateway status顯示非預期監聽端，代表政策——而非二進位——有誤。 - 無頭缺口： 若驗收沒有 GUI 破窗計畫，第一次 TCC 迴歸就會失敗——請將 VNC 文件化，而非視為羞恥。
維運規則： 若無法將三行——版本、doctor 摘要、閘道狀態——貼入變更紀錄，主機不得升級至正式。
矩陣 A — 冒煙檢查、通過準則與證據產物
| 檢查 | 通過準則 | 證據產物 |
|---|---|---|
| CLI 語意鎖定 | openclaw --version 與釘選發行一致 |
票據附件或 CI 日誌摘錄 |
| Doctor 基線 | openclaw doctor 以零結束；相較黃金主機無新警告 |
遮罩後 stdout 於物件儲存 |
| 閘道姿態 | openclaw gateway status 僅顯示預期監聽端 |
螢幕截圖或結構化 JSON 擷取 |
| 磁碟餘裕 | 工作卷可用空間 ≥ 最大突發產物的 2 倍 | 票據內 df 摘錄 |
矩陣 B — 症狀、解讀與下一步
| 症狀 | 可能解讀 | 下一步 |
|---|---|---|
| Doctor 乾淨，webhook 401 | 權杖檔可讀，但非 launchd 所用 | 比對使用者脈絡；重跑無頭驗收核對清單。 |
| 狀態顯示額外監聽端 | 設定漂移或手動覆寫 | 比對 plist 環境與儲存庫；流量前先回滾綁定旗標。 |
| 模型呼叫後就緒探針抖動 | 就緒探針對 GPU 暖機過嚴 | 依就緒 SLO 文章將存活與模型就緒拆分。 |
變更視窗的數值護欄
- 證據 SLA： launchd 重新載入後 30 分鐘 內附上冒煙輸出，否則自動回滾。
- Doctor 差異： 相較黃金主機至多 兩 則新警告；超出即為合併阻擋。
- Webhook 演練： 切換正式入口前，於測試至少 五 次已簽章重播。
八個 HowTo 步驟（與 JSON-LD 對應）
- 鎖定 CLI：將
openclaw --version記入變更單。 - 執行 doctor 並儲存 stdout，供編輯 plist 或環境前後比對。
- 檢視閘道狀態，確認監聽端遵循 loopback 優先政策。
- 量測磁碟 於工作區根目錄；啟用重型工具鏈前先擴卷。
- 驗證 LaunchAgent 身分，使鑰匙圈分割與祕密範圍一致。
- 套用就緒拆分：先快速存活，其次為依模型檢查。
- Webhook 乾跑，含寫實內文大小與時鐘偏移邊界。
- 演練回滾 plist 與權杖而不刪稽核日誌。
常見問題
CI 是否應執行相同冒煙套件？
是，但僅限非互動檢查；依 GUI 的步驟應落在已標記的測試池並附 VNC 破窗文件。
長壽主機應多久重跑冒煙？
至少每日以 launchd 友善的排程，並於每次祕密輪替後執行；缺證據視同失敗，而非「略過」。
誠實的 OpenClaw 維運在 原生 macOS 上需要以 SSH 為先的自動化，並將 VNC 保留給同意邊界。嚴謹的安裝後矩陣可避免「儀表板綠燈、客戶紅燈」，將 openclaw --version、openclaw doctor 與 openclaw gateway status 綁到稽核可重播的證據。橫跨 香港、日本、韓國、新加坡與美國 租用專用 Mac mini M4 可取得隔離主機，使測試冒煙與正式冒煙不會意外共用鑰匙圈命名空間。當矩陣顯示反覆漂移時，請透過 定價 增主機，而非讓單一閘道橫跨不相容角色。