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，见 套餐页。