2026 OpenClaw レンタル Mac Mini 実戦:memory.qmd ローカル索引の夜間再構築、searchTool 钉扎と config 再起動環を避ける再現手順

約9分

レンタル Mac MiniOpenClaw七×二十四運用する際、memory.qmdの昼間増分と夜間全量再構築がずれると、検索が半新半旧になります。searchToolのパス漂移はmcporter検証失敗と再起動環を招きます。

本稿はローカル RAG/QMD の推奨値マトリクスconfig validate→applylaunchd深窓とHealthchecks心拍を七手順劣化 FAQで固定します。ホーム料金APFS 水位 FAQlaunchd 节流稿と併読ください。

七×二十四で memory.qmd が破綻しやすい三つの理由

  1. 索引の撕裂。 昼間の増分と夜間全量が IO を奪い合い、ベクトルとメタデータが不整合になります。
  2. 検証の踏み抜き。 searchToolを钉さずに config を書き換えると、起動時 mcporter が失敗し launchd が再起動環に入ります。
  3. 設定の嵐。 ファイル監視が半成品 config で連続 reload し、config validate を飛ばした apply が夜批を中断します。

レンタル Mac Mini でローカル RAG/QMD を載せるシーン

社内ドキュメント・Runbook・会話ログをオンデバイスに留めたい独立開発者向けです。memory.qmd は QMD 形式のチャンク索引で、ゲートウェイの searchTool から参照されます。クラウドベクトル DB へ出さないため、レンタル Mac Miniの APFS 上で完結させやすい構成です。

  • 夜間のみ全量再構築し、昼は増分のみ。深窓外は読取専用スナップショットを参照します。
  • OPENCLAW_HOME 配下に索引と staging を分離し、権限は自動化ユーザーに限定します。
  • ゲートウェイは 127.0.0.1 ループバックに固定し、外向き通知は Webhook のみです。
openclaw onboard --install-daemon
export OPENCLAW_HOME=~/openclaw-prod
openclaw gateway status
# 期待: bind 127.0.0.1 keepalive launchd

memory.qmd/searchTool 推奨値マトリクス

制御項目 推奨値 補足
増分間隔十五分深窓外のみ。IO 尖峰を避ける
夜間全量UTC 22:30 開始06:00 前に完了目標
chunk 上限五一二トークンoverlap 六四
embedding 版config に固定昇格前に validate 必須
searchTool パス絶対パス+sha256mcporter 起動時検証
ThrottleInterval九十〜百二十秒ゲートウェイ再起動環抑制

searchTool 钉扎(mcporter 検証失敗の回避)

searchTool の実行ファイル・索引ルート・モデル ID を runbook に钉し、config ではシンボリックリンクではなく絶対パスを書きます。昇格前は $OPENCLAW_HOME/stagingopenclaw config validate を必ず成功させます。

openclaw config validate --path staging/openclaw.json
# mcporter + searchTool dry-run OK 後のみ:
openclaw config apply --atomic staging/openclaw.json

権限は索引ディレクトリが自動化ユーザー読取専用、staging のみ書込可。詳細は SQLite WAL 稿の IO 公平と併用してください。

夜間再構築窓とディスク水位

  • APFS 黄十五・赤十:黄で全量再構築を停止し増分のみ。赤で埋め込みも止め Webhook ページ。
  • 再構築 Job は Nice 10 と IO 優先度を下げ、ゲートウェイより後ろに回します。
  • 索引一時ファイルは .reindex-tmp に書き、成功後に原子的 rename。

水位閾値は APFS 水位 FAQと同一カレンダーで揃えます。

config 再起動環の回避(先に validate、後で apply)

  1. 編集は常に openclaw.json.tmp。保存直後の watch reload を無効化します。
  2. config validate が mcporter・searchTool・memory パスを検査。失敗時は稼働 config に触れません。
  3. config apply --atomic で差替え、ゲートウェイへは単回 HUP のみ。連続再起動を防ぎます。

ゲートウェイ Label の ThrottleInterval 九十秒 以上を併用し、誤設定時の launchd 嵐を抑えます。

launchd サイレンス窓と Healthchecks/汎用 Webhook 心拍

再構築 LaunchAgent は UTC 22:00–06:00 のみ StartCalendarInterval。サイレンス中の失敗 Webhook は抑制し、データ欠損のみ P1 貫通します。

# reindex 完了後
curl -fsS -m 10 "$HC_URL/$UUID"
# 失敗時
curl -fsS -m 10 "$HC_URL/$UUID/fail"

Grace・fail slug の設計は Healthchecks 稿を参照。汎用 Webhook は batch_id:reindex_phase で去重します。

再現のための七手順

  1. ノード確保。 公開購入後、ヘルプから SSH し df -h 基線を記録します。
  2. onboard。 openclaw onboard --install-daemon でループバックゲートウェイを載せます。
  3. 索引布局。 memory.qmd・staging・checkpoints を OPENCLAW_HOME 下に分離します。
  4. 钉扎。 searchTool 絶対パスと sha256 を runbook に書き、validate を CI 同等に回します。
  5. 夜間 Job。 launchd で再構築と Nice/IO を設定。节流稿と整合します。
  6. 心拍。 Healthchecks または汎用 Webhook に成功/fail を分離します。
  7. 演習。 意図的に validate 失敗を起こし、稼働 config が変わらないことを確認します。

運用で貼る引用三行

  • 深窓 UTC 22:00–06:00/増分 十五分/chunk 512+64 overlap
  • ディスク黄 15%10%/Throttle 90–120s
  • 手順は必ず validate→apply。心拍は再構築フェーズごとに分離。

長距離タスク劣化 FAQ

夜間再構築で昼間ゲートウェイは落ちますか

深窓と Nice/IO 優先度で分離します。黄水位では全量を止め増分のみ。赤では硬停止し Webhook でページします。

なぜ validate を apply より先に実行するか

validate は staging 上で mcporter と searchTool を検査し、失敗時は稼働 config に触れません。apply は原子的差替えと単回 HUP のみです。

mcporter 検証失敗の典型原因は

searchTool パス漂移、索引権限、embedding 版不一致です。絶対パスと sha256 を钉し、昇格前に staging で validate します。

七×二十四 memory.qmd 索引を載せる Mac Mini 長期レンタル

RunMiniApple SiliconノードでOpenClawmemory.qmd夜間再索引を載せます。料金公開購入(ログイン不要)・SSH/VNC ヘルプ

まとめ: memory.qmdsearchTool钉扎・config validate・夜間深窓を同一 runbook に書けば、レンタル Mac Mini上のOpenClawは再起動環なしで七×二十四に近づきます。 ホームへ戻れます。

memory.qmd 七×二十四 · Mac Mini レンタル