2026 OpenClaw レンタル Mac Mini 実戦:memory.qmd ローカル索引の夜間再構築、searchTool 钉扎と config 再起動環を避ける再現手順
レンタル Mac MiniでOpenClawを七×二十四運用する際、memory.qmdの昼間増分と夜間全量再構築がずれると、検索が半新半旧になります。searchToolのパス漂移はmcporter検証失敗と再起動環を招きます。
本稿はローカル RAG/QMD の推奨値マトリクス、config validate→apply、launchd深窓とHealthchecks心拍を七手順と劣化 FAQで固定します。ホーム・料金・APFS 水位 FAQ・launchd 节流稿と併読ください。
七×二十四で memory.qmd が破綻しやすい三つの理由
- 索引の撕裂。 昼間の増分と夜間全量が IO を奪い合い、ベクトルとメタデータが不整合になります。
- 検証の踏み抜き。 searchToolを钉さずに config を書き換えると、起動時 mcporter が失敗し launchd が再起動環に入ります。
- 設定の嵐。 ファイル監視が半成品 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 パス | 絶対パス+sha256 | mcporter 起動時検証 |
| ThrottleInterval | 九十〜百二十秒 | ゲートウェイ再起動環抑制 |
searchTool 钉扎(mcporter 検証失敗の回避)
searchTool の実行ファイル・索引ルート・モデル ID を runbook に钉し、config ではシンボリックリンクではなく絶対パスを書きます。昇格前は $OPENCLAW_HOME/staging で openclaw 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)
- 編集は常に
openclaw.json.tmp。保存直後の watch reload を無効化します。 - config validate が mcporter・searchTool・memory パスを検査。失敗時は稼働 config に触れません。
- 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 で去重します。
再現のための七手順
- ノード確保。 公開購入後、ヘルプから SSH し
df -h基線を記録します。 - onboard。
openclaw onboard --install-daemonでループバックゲートウェイを載せます。 - 索引布局。 memory.qmd・staging・checkpoints を OPENCLAW_HOME 下に分離します。
- 钉扎。 searchTool 絶対パスと sha256 を runbook に書き、validate を CI 同等に回します。
- 夜間 Job。 launchd で再構築と Nice/IO を設定。节流稿と整合します。
- 心拍。 Healthchecks または汎用 Webhook に成功/fail を分離します。
- 演習。 意図的に 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 長期レンタル
RunMiniのApple SiliconノードでOpenClawとmemory.qmd夜間再索引を載せます。料金・公開購入(ログイン不要)・SSH/VNC ヘルプ。
まとめ: memory.qmd・searchTool钉扎・config validate・夜間深窓を同一 runbook に書けば、レンタル Mac Mini上のOpenClawは再起動環なしで七×二十四に近づきます。 ホームへ戻れます。