2026年 OpenClaw Active Memory 與子代理在遠端實體 Mac 上的可複現落地：MEMORY.md 遷移、觸發熱度與 JSONL 稽核對齊閘道沙箱——7×24 長工作階段場景的 Runbook（設定片段 + 常見報錯 FAQ）

2. 痛點拆解

1. 限制：相對路徑 × 多重 cwd。 子代理若從儲存庫子目錄啟動，可能在深層樹寫入另一份 MEMORY.md，而父行程仍讀舊位置——這是路徑分裂，不是「神秘失憶」。
2. 隱性成本：寫入熱度即寫放大。 每回合 fsync 級的全量覆寫，疊加稽核 JSONL，可能在業務流量前先讓 7×24 主機的 iowait 觸頂。
3. 穩定性與稽核：雙寫者、雙目錄。 沙箱阻擋主機路徑時，子代理把稽核落在私有目錄，主機端 jq 外連失敗——多半是 requestId 與可寫路徑政策從未統一。

3. 決策矩陣

上線前用下列兩表對齊「記憶載體」與「刷新策略」，避免在 staging／production 之間反覆改契約。

4. 設定片段（對齊沙箱）

下列 JSON 為示意，欄位名稱須與你釘選的 OpenClaw 版本文件一致。不可妥協者為：絕對路徑、可寫清單、requestId 傳遞。

{
  "memory": {
    "path": "/Users/ocagent/workspace/MEMORY.md",
    "encoding": "utf-8",
    "flush": { "maxEvents": 32, "intervalMs": 5000, "halfLifeRounds": 12 }
  },
  "subagents": {
    "defaultCwd": "/Users/ocagent/workspace",
    "inheritEnv": ["OPENCLAW_REQUEST_ID", "MEMORY_PATH"]
  },
  "gateway": {
    "auditJsonl": "/Users/ocagent/logs/gateway-audit.jsonl",
    "sandbox": {
      "writable": [
        "/Users/ocagent/workspace/.sandbox/scratch",
        "/Users/ocagent/logs/sandbox-audit.jsonl"
      ]
    }
  }
}

在 launchd plist 匯出 MEMORY_PATH 與 OPENCLAW_REQUEST_ID（或由閘道包裝器依請求設定），避免 SSH 前景與無人值守常駐行程分叉。

5. 七步 Runbook（遠端實體 Mac）

1. 凍結權威路徑。 在 Runbook 封面同時寫死 MEMORY 檔、稽核 JSONL 與沙箱暫存目錄的絕對路徑——維基與程式註解不得各自一套。
2. 遷移 MEMORY.md。 維護窗或唯讀模式下複製，以 diff 驗證，於標頭區塊標記 migratedAt。
3. 正規化子代理 cwd。 強制 defaultCwd 指向主工作區，或傳遞等價的記憶體旗標。
4. 啟用 JSONL 欄位契約。 約定 ts、level、requestId、actor、memoryOp、durationMs 於閘道與子行程一致。
5. 沙箱驗收。 探針：白名單外寫入失敗並寫入 deny 行；成功寫入僅落在 writable。
6. 調校寫入熱度。 由每回合全量刷新改為視窗批次後，以 24 小時對話稿重播並觀察 iostat 與 JSONL 增長。
7. 重播外連。 以 jq 依 requestId 外連主機與沙箱 JSONL；任缺配對即阻擋上線。

6. 可引用閾值

• 批次刷新起步視窗： 約 3–8 秒或 16–32 筆事件，先到先刷新；極長工作階段可配合半衰期拉長。
• 稽核 JSONL 輪替： 單檔接近 128–256 MB 即切分，避免物件同步拖著數 GB 尾段。
• 外連 SLA： 預生產浸泡一小時內 requestId 缺配對率應為 0%；正式環境若排除你文件化的時鐘桶後仍高於 0.1% 即告警。

7. FAQ

8. 總結：為何 Mac mini 適合長工作階段的記憶體＋稽核 IO

Active Memory 搭配 JSONL 稽核，本質是高頻小區塊 IO 加上長生命週期行程：磁碟品質、排程器公平性與功耗曲線決定你的寫入熱度策略能否穩定落地。Apple Silicon Mac mini（例如 M4）以統一記憶體頻寬搭配約 4W 級待機功耗，適合靜音 7×24 閘道把記憶與日誌留在本機高速儲存上。

macOS 亦提供 launchd、Unified Logging 與 APFS 快照，當沙箱 deny 行或批次刷新迴歸出現時，分診路徑較短；搭配 Gatekeeper 與 SIP，相較常見的常駐 Windows 主機，惡意軟體暴露面更低。

若你正把長工作階段從筆電遷到遠端實體 Mac，希望子代理、閘道沙箱與 JSONL 輪替共用同一套可預測基線，Mac mini M4 是目前最具性價比的錨點之一：路徑凍結一次，同一硬體剖面即可貫穿 staging 與 production。若你希望把本文方案跑在更流暢、低噪音且可長期併行的硬體上，現在即可前往首頁了解 ZoneMac 的實體 Mac 節點方案。