2026 OpenClaw 租用 Mac Mini 實戰
memory.qmd 本地索引夜間重建、searchTool 釘扎與避免 config 重啟環的可複現步驟

⚡痛點拆解

1. 索引撕裂：白天 memory.qmd 增量與夜間全量重建搶 IO，查詢讀到舊向量與新元資料混搭。
2. 校驗踩雷：改 searchTool 路徑未釘扎，mcporter 在閘道啟動時失敗，守護行程進入重啟環。
3. 設定風暴：檔案監視器對半成品 config 反覆 reload，未走 config validate 就 apply，夜批被連環打斷。

租用 Mac Mini 做本地 RAG/QMD 的場景

適合七乘二十四無人值守：知識庫在租機本地、對話走迴圈閘道，檢索走 memory.qmd 索引而非每次打雲端向量庫——降延遲、控成本、離線可稽核。

• 白天：對話增量寫入 $OPENCLAW_HOME/memory/，searchTool 唯讀查詢。
• 夜裡：launchd 觸發全量或分段重建，與閘道推理錯峰。
• 釘版本：OpenClaw、embedding 模型、mcporter 寫入跑冊，換機可複現。

# 目錄約定（範例）
export OPENCLAW_HOME=/var/openclaw/prod
export MEMORY_QMD=$OPENCLAW_HOME/memory/index.qmd
export MEMORY_STAGING=$OPENCLAW_HOME/memory/staging/

memory.qmd 與 searchTool 推薦值（決策矩陣）

釘扎 searchTool（避免 mcporter 校驗失敗）

跑冊用絕對路徑寫 searchTool.binary 與 indexDir，附 sha256；升級前在 $OPENCLAW_HOME/config.staging/ 做 validate。

# pin-manifest.json（片段）
{
  "searchTool": "/opt/openclaw/bin/mc-search",
  "indexDir": "/var/openclaw/prod/memory/index",
  "sha256": "a1b2…"
}

• 禁止 Homebrew 升級後相對路徑靜默漂移。
• mcporter 自檢失敗時不觸碰執行中 config。

夜間重建視窗與磁碟水位

全量重建只在 UTC 22:00–06:00 深窗；Nice 10 與 IOPriority=utility 見 launchd 節流專文。

• 黃線：暫停新嵌入，僅查詢；staging 目錄唯讀。
• 紅線：kill 重建 Job，Webhook 立即頁。
• 重建日誌 128MB×7 newsyslog，與閘道日誌分檔案。

觸發重啟環的規避：先 config validate 再 apply

#!/bin/bash
set -euo pipefail
STAGING="$OPENCLAW_HOME/config.staging/openclaw.yaml"
openclaw config validate --config "$STAGING"   # 含 mcporter + searchTool
install -m 0644 "$STAGING" "$OPENCLAW_HOME/config/openclaw.yaml"
openclaw gateway reload-once                 # 單次 HUP，禁止 watch 環

檔案監視器對 staging 目錄忽略；僅 apply 成功後 touch .config_generation 供探針讀。

launchd 靜默視窗與 Healthchecks／通用 Webhook 心跳

重建 Label 與閘道 Label 分離；重建 Job 的 StandardOutPath 固定，ThrottleInterval 120s 防崩潰環。

# 段末心跳（Healthchecks 或通用 Webhook）
curl -fsS -m 10 -X POST "$HC_URL/$SLUG" \
  -d '{"batch_id":"'"$BATCH"'","phase":"reindex_done"}'

細節見 Healthchecks 夜批稿 與 launchd 健康矩陣；靜默內失敗只記日誌。

可複現落地步驟（七步）

1. 經 購買頁 開通租機，SSH 自 幫助中心 連入，採 df -h 基線。
2. 建立 memory/ 與 staging 目錄，寫入 pin-manifest。
3. 設定 searchTool 與 memory.qmd 路徑，openclaw config validate 透過後再 apply。
4. 載入 launchd 夜間重建 plist（UTC 02:30，Nice/IO 見矩陣）。
5. 接 Healthchecks 或通用 Webhook 心跳，段末 POST reindex_done。
6. 設 APFS 黃紅閘口與 newsyslog；對齊磁碟 FAQ。
7. 演練：故意 validate 失敗，確認執行 config 未被替換、無重啟環。

可引用資訊

• 重建窗：UTC 02:30；深窗 22:00–06:00。
• Top-K 6–8；分塊 512–768 token。
• 磁碟黃 15% 紅 10%；重建日誌 128MB×7；Throttle 120s。

長跑任務降級 FAQ

問：白天對話變慢是否該立刻全量重建？ 答：先查磁碟黃線與 Top-K；僅在深窗跑全量，白天用增量或降 K。

問：validate 過但 apply 後仍重啟環？ 答：查 watch 是否監視 staging；改 reload-once 並抬 ThrottleInterval。

問：租機託管還是自建？ 答：七乘二十四長跑建議 租用 Mac Mini 託管閘道與重建 Job，見 套餐頁。