MacLogin 雲端 Mac 上的 OpenClaw 工作區磁碟垃圾回收:2026 年 4 月修剪手冊,讓閘道器線上且不刪佇列
當租用 Apple Silicon mini 上的 OpenClaw 閘道器開始超時,團隊往往在真兇是 APFS 卷已滿很久之後,還在指責“模型 API”。 2026 年 4 月實踐:把磁碟當作佇列依賴——先快照利用率,把目錄分為安全修剪與高風險刪除兩類,用清單驅動修剪,並且僅在 openclaw doctor 顯示綠色餘量後再重啟 launchd 任務。本手冊列出熱點路徑、釋出二元決策矩陣、編排八條操作步驟、把日誌輪轉與統一日誌上限掛鉤、在破壞性刪除前強制狀態備份,並以港日韓新美機隊 FAQ 收尾。
請與 狀態目錄備份交接、doctor 診斷手冊、以及激進清理快取後的 npm 對等依賴重建 對照閱讀。公開入口:幫助 與 定價。
在多團隊共享的 MacLogin 租約上,磁碟壓力常與“人類除錯 + CI 外掛 + 錄屏排障”疊加。若不在周例會上公開熱點路徑表,每個人都會假設“別人會清快取”,直到閘道器因無法寫臨時檔案而拒絕 webhook。把磁碟當作一等指標後,你會更快發現:許多超時並不是模型慢,而是 fsync 在滿盤上排隊。
本手冊假設讀者已能登入租約並具備 sudo 或等價運維許可權;若你在完全託管環境,請把本文當作與平臺團隊的共同語言,而不是私自遞迴刪除的許可證。任何刪除前,請確認工單裡已有 doctor JSON 與備份雜湊。
在 OpenClaw 尖叫之前,磁碟會先尖叫的症狀
磁碟壓力常偽裝成“自動化不穩定”。留意:
- 閘道器健康檢查 在本地成功,但 webhook 回執成批到達——常見是日誌 fsync 卡頓。
- Node 包安裝 原本兩分鐘突然超過十分鐘,尤其在 OpenClaw 外掛升級把 tarball 解到工作區暫存之後。
- macOS “儲存空間幾乎已滿” 彈窗出現在螢幕共享會話中,而工程師仍堅稱“我們只跑文字智慧體”。
若你把閾值設得過鬆,會在一次外掛釋出會後同時觸發數十臺 mini 的磁碟告警;若設得過緊,又會在正常構建波峰期製造噪音。建議把閾值與佇列深度、併發沙箱數量一起畫在同一張折線圖上做季度回顧。
熱點路徑清單:多租戶雲端 Mac 上什麼長得最快
並非每一兆位元組都屬於 OpenClaw,但閘道器程序與開發者雜項共址。周衛生檢查時使用下表;按組織自定義外掛路徑擴充套件行。
| 路徑模式 | 典型增長驅動 | 可安全修剪 | 誤刪風險 | 備註 |
|---|---|---|---|---|
~/.openclaw/tmp | Webhook 重放緩衝 | 有工單後可 | 低 | 超過 72 小時輪轉 |
~/.npm 快取 | 外掛安裝 | 可 | 中 | 下次安裝更久 |
~/Library/Logs 統一日誌映象 | 冗長閘道器周 | 有上限可 | 低 | 與 SOC2 留存協調 |
~/.openclaw/state 佇列 | 卡住的任務 | 無備份不可 | 高 | 先排空佇列 |
某些團隊會把大型語言模型權重放在家目錄旁側目錄;這些路徑不會出現在 OpenClaw 預設清單裡,但會擠壓同一 APFS 容器。請在內部清單中加一行“模型權重路徑”,並在定價討論裡把權重盤與閘道器盤拆租。
二元修剪矩陣(事故壓力下快速回答)
| 問題 | 若答是 | 若答否 |
|---|---|---|
| doctor JSON 匯出已附在工單? | 可繼續安全刪除 tmp | 停止——先跑 doctor |
| 過去 30 分鐘內已做 tarball 備份? | 允許對 soul-memory 歸檔做破壞性輪換 | 按 交接指南 先備份 |
| 是否有工程師正在螢幕共享? | 推遲大刪除 | 繼續 IO 輕量 passes |
矩陣刻意做成二元,是為了在凌晨三點減少決策樹深度:先回答備份與 doctor,再回答人機是否共屏,最後才談刪除範圍。把“我大概備份了”改成工單裡的雜湊附件,能顯著降低迴滾爭議。
八步手冊(2026 年 4 月修訂)
- 凍結 會生成新沙箱的出站實驗,直至修剪完成。
- 捕獲
df -h與 inode 統計寫入事件工單。 - 匯出
openclaw doctor --json(或組織等價命令)再對磁碟做任何變更。 - 歸檔
~/.openclaw,按備份文章使用帶雜湊的 tarball 命名。 - 修剪 tmp、輪轉日誌與舊外掛構建產物,遵循上表。
- 抽空 npm 快取,若本就計劃做對等依賴重建。
- 重啟 閘道器:僅在確認至少 15 GB 空閒後執行
launchctl kickstart -k。 - 再匯出 doctor JSON,與第三步 diff;將 diff 附在關單評論。
第八步的 diff 是審計最愛看的附件:它證明你不是“憑感覺刪檔案”,而是用同一探針在前後對照。若 diff 顯示外掛版本漂移,請另開缺陷單跟蹤,而不是混在磁碟事件裡。
閘道器日誌、統一日誌與為何“刪控制檯”很敷衍
macOS 統一日誌在排障後若仍保持 debug 級別,可能吞掉數 GB。請在閘道器層把結構化 JSON 行路由到按日輪轉、保留 七 份冷複製的受限檔案,除非合規要求更久。離線上傳前先壓縮——對人類仍在螢幕共享旁除錯的場景,頻寬同樣寶貴。
若你把日誌 ship 到 SIEM,請確認欄位脫敏與取樣策略不會反向撐爆租約磁碟;見過團隊在本地留全量、在雲端再做取樣,結果雙份付費。
破壞性操作前先備份狀態(不可協商)
OpenClaw 的價值在於連續性:排隊 webhook、半完成的工具審批、soul-memory 指標。未讀符號連結就刪“只是快取”,搞砸的實驗室比任何 CVE 討論都多。請字面遵循 狀態目錄備份交接——給歸檔算雜湊,儘量存到租約外,並記錄誰持有加密金鑰。
備份檔名裡務必含租約 ID 與時間戳,避免不同區域的同名 tarball 在物件儲存裡互相覆蓋。恢復演練應每季度做一次,否則真出事時你會發現金鑰在已離職員工的個人密碼庫裡。
區域機隊現實:香港、東京、首爾、新加坡與美國
磁碟壓力並不均勻。新加坡與香港租約常承載跨境 CI 突發,npm 快取比單區域美國團隊預期填得更快。日本企業常要求更長日誌留存——請按國家而非泛化“雲規則”制定輪轉。韓國遊戲相鄰客戶可能把大資源包放在 OpenClaw 旁;用獨立配額隔離。美國客戶若把 Ollama 權重與 OpenClaw 混放,有二級卷時應把權重掛到副卷。
當三個以上併發閘道器實驗並存導致 footprint 爆炸,請用 定價 拆租約而不是無限修剪——硬體比 pager 疲勞便宜。
跨國團隊還要考慮資料駐留:把日誌 tarball 上傳到境外桶前,先過法務白名單,否則磁碟問題會升級成合規事件。
常見問題
MacLogin 會自動修剪我的工作區嗎? 檔案生命週期由客戶負責;我們提供容量——參見 幫助 中的監控掛鉤建議。
是否應禁用外掛省磁碟? 先度量;外掛本體可能比其快取更小。
Docker 呢? 若共址容器,請單獨 prune 映象;本文聚焦 OpenClaw 原生路徑。
能否用定時任務自動刪 tmp? 可以,但必須把 doctor 與佇列排空檢查寫進同一指令碼 guard,否則可能在 webhook 重放中途刪緩衝。
為何 Mac mini M4 統一記憶體在磁碟抖動時仍利於 OpenClaw
當 APFS 在大工作區複製期間執行寫時複製,M4 的統一記憶體頻寬讓閘道器在 tarball 流式傳輸時仍保持響應。這對首爾與東京團隊同時匯出 doctor 尤其重要。向 MacLogin 增租 mini,把“實驗”與“生產”閘道器隔離,可降低破壞性修剪頻率並縮短事件視窗。
把硬體擴容與運維紀律配對:每季度先在從 定價 模板克隆的非生產租約上演練本手冊,再推廣 survived 的自動化。
若你在讀到這裡仍覺得“刪一點日誌就好”,請回到矩陣第一行:沒有 doctor JSON 的磁碟操作,本質上是一次未批准的變更。