2026 OpenClaw 맥 미니 대여 실전: memory.qmd 로컬 인덱스 야간 재색인·searchTool 핀·config 재시작 환 회피

칠곱이십사에서 memory.qmd 가 깨지는 세 가지

1. 인덱스 찢김 — 낮 증분과 밤 전량 재색인이 IO 를 나눠 벡터·메타데이터가 엇갈립니다.
2. mcporter 실패 — searchTool 상대 경로가 Homebrew 업그레이드 후 바뀌면 게이트웨이가 재시작 루프에 들어갑니다.
3. 설정 폭풍 — 스테이징 config 를 watch 가 잡아 reload 를 반복하면 야간 배치가 끊깁니다.

맥 미니 대여로 로컬 RAG/QMD 를 쓰는 장면

지식이 렌탈 노드 로컬에 있고 대화는 루프백 게이트웨이, 검색은 memory.qmd — 클라우드 벡터 API 비용·지연·감사 부담을 줄입니다.

• 주간 — $OPENCLAW_HOME/memory/ 증분, searchTool 은 읽기 전용.
• 야간 — launchd 전량·분할 재색인, 추론과 창을 분리.
• 핀 — OpenClaw·임베딩·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. 스테이징에서 먼저 validate.

# pin-manifest.json (발췌)
{ "searchTool": "/opt/openclaw/bin/mc-search",
  "indexDir": "/var/openclaw/prod/memory/index",
  "sha256": "a1b2…" }

• mcporter 자가검사 실패 시 운영 중 config 를 건드리지 않음.
• 상대 경로·심볼릭 링크 드리프트 금지.

야간 재색인 창·디스크 수위

전량 재색인은 UTC 22:00–06:00 깊은 창만. Nice 10·IOPriority=utility 는 런치디 스로틀 참고.

• 황색 15% — 신규 임베딩 중지, 쿼리만.
• 적색 10% — 재색인 Job kill + Webhook 페이징.
• 재색인 로그 128MB×7 newsyslog, 게이트웨이와 분리.

재시작 환 회피: config validate 후 apply

STAGING="$OPENCLAW_HOME/config.staging/openclaw.yaml"
openclaw config validate --config "$STAGING"
install -m 0644 "$STAGING" "$OPENCLAW_HOME/config/openclaw.yaml"
openclaw gateway reload-once

watch 는 staging 무시. apply 성공 후만 .config_generation touch.

launchd 침묵창·Healthchecks/범용 Webhook 심박

재색인 Label 과 게이트웨이 Label 분리. ThrottleInterval 120s 로 크래시 루프 방지.

curl -fsS -m 10 -X POST "$HC_URL/$SLUG" \
  -d '{"batch_id":"'"$BATCH"'","phase":"reindex_done"}'

Healthchecks 칠곱이십사·launchd 헬스 매트릭스와 동일 침묵 정책.

재현 가능한 일곱 단계

1. 홈·구매·고객센터로 노드·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 으로 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