$cd ../troubleshooting/
High⚡ Performance
Dreaming 孤立セッション — ディスク肥大化とゲートウェイ起動遅延
// OpenClawのメモリ「dreaming」機能はアイドル時に長期コンテキストを統合します。2026年の複数ビルドで既知のバグがあり、一時セッションディレクトリがGCされず残ります — ユーザー報告では~/.openclaw/agents/main/sessions/が5〜50 GB、ゲートウェイ起動に30秒以上かかる例があります。
diagnose.sh
🔍 これがあなたの問題ですか?
?du -sh ~/.openclaw/agents/main/sessions/ が数GB(多くは5〜50 GB)
?ゲートウェイ再起動またはopenclaw gateway statusが新規インストールより15〜60秒遅い
?古いmtimeのdream-temp-*またはtmp-*が大量にあり、アクティブなチャットから参照されていない
measure_bloat.sh
✅ 修正1 — セッションディレクトリの肥大化を測定
削除前のベースライン測定
# セッションストレージ合計
du -sh ~/.openclaw/agents/main/sessions/
# セッション関連ディレクトリ数
find ~/.openclaw/agents/main/sessions/ -maxdepth 1 -type d | wc -l
# 最大のdream-tempフォルダ
find ~/.openclaw/agents/main/sessions/ -name 'dream-temp-*' -type d -exec du -sh {} \; | sort -hr | head -20cleanup_orphans.sh
✅ 修正2 — 孤立した一時セッションを安全に削除
まず隔離;48時間正常なら隔離を削除
# 先にゲートウェイ停止
openclaw gateway stop
# 孤立候補をプレビュー(14日以上、dream-temp)
find ~/.openclaw/agents/main/sessions/ \
-maxdepth 1 -type d -name 'dream-temp-*' -mtime +14 -print
# 隔離へ移動(rmより安全)
mkdir -p ~/openclaw-session-quarantine
find ~/.openclaw/agents/main/sessions/ \
-maxdepth 1 -type d -name 'dream-temp-*' -mtime +14 \
-exec mv {} ~/openclaw-session-quarantine/ \;
openclaw gateway startopenclaw.json
✅ 修正3 — Dreamingを調整または無効化
保持ポリシーを調整 — ディスクが厳しければ無効化
# ~/.openclaw/openclaw.json
{
"agents": {
"defaults": {
"dreaming": {
"enabled": true,
"interval": "0 3 * * *",
"maxTempSessions": 50,
"retainTempDays": 3
}
}
}
}
# 完全無効化:
# "dreaming": { "enabled": false }💡 プロのヒント:週次クリーンアップをスケジュール
7日より古いdream-temp-*フォルダを削除するcronジョブを追加してください。将来のビルドでGCロジックが退行してもディスク使用量を一定に保てます。一括削除の前に必ずゲートウェイを停止してください。
🛡️ 予防チェックリスト
- • dreaming有効化後、最初の1か月は週次でdu -sh ~/.openclaw/agents/main/sessions/を確認
- • ゲートウェイを最新パッチに保つ — 2026.3.xの複数リリースで一時セッションクリーンアップが改善
- • ビルドがサポートする場合agents.defaults.dreaming.maxTempSessionsを設定(孤立の増加を抑制)
- • 一括rmの前にアクティブなsession JSONをバックアップ — mtime未確認でsess-*を削除しない
- • VPSでは~/.openclaw専用ディスクまたはクォータを使い、肥大化でルート/を埋めない
❓ FAQ
Q1. OpenClawの「dreaming」とは?
dreamingはバックグラウンドのメモリ統合処理です。エージェントがアイドル中、古い会話ターンを要約してコンパクトなメモリファイルに書き込み、全文を再ロードせず一貫した応答を可能にします。処理中はagents/<id>/sessions/に一時ディレクトリを作成します。クリーンアップが失敗するとこれらが孤立します。
Q2. sessionsフォルダ内をすべて削除しても安全ですか?
いいえ。アクティブセッション(sess-<uuid>でmtimeが新しいもの)はライブチャンネル状態を保持します。dream-temp-*、tmp-*、.partial-*パターンのみ、またはセッションインデックスに対応がないディレクトリのみ削除してください。不明な場合は隔離フォルダへ移動してゲートウェイを再起動 — チャンネルが正常なら48時間後に隔離を削除。
Q3. 巨大なsessionsフォルダが起動を遅くする理由は?
ゲートウェイ起動時にセッションメタデータをスキャンしインデックスを再構築、チャンネルバインディングを検証します。古いディレクトリが1万あると、最初のメッセージ前に大量のstat()とJSON解析が発生します。HDDのMac MiniやRaspberry Pi SDで顕著、NVMeでも2万エントリ超で遅延します。
Q4. dreamingを無効にするとエージェントの記憶は壊れますか?
dreamingは長期記憶を改善しますが日常チャットに必須ではありません。無効化すると新しい一時ディレクトリは増えません。agents/<id>/memory/の既存長期メモリは残ります。数週間前の会話参照がやや弱くなる可能性 — ストレージ制約のあるホストでは許容できるトレードオフです。
Q5. 孤立した一時ファイルと本物のセッションの見分け方は?
孤立ファイルはdream-temp-<timestamp>、.dream-work-<id>、tmp-merge-*などの名前で、dreaming完了後にmtimeが更新されません。本物のセッションは受信メッセージごとにmtime更新。dream-temp*にfind -mtime +14 — ゲートウェイが稼働中なのに2週間触られていなければ孤立です。
Q6. クリーンアップ後にGitHub issueを開くべきですか?
github.com/openclaw/openclaw公式ビルドを使っているならはい。openclaw --version、du -sh出力、find … | wc -lカウント、dreaming設定スニペットを添付。セッション内容は貼らないでください — 非公開メッセージを含む可能性があります。