OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Sessions and memory

Dreaming

Dreaming は、memory-core のバックグラウンドメモリ統合システムです。強い短期シグナルを永続的なメモリへ移行しながら、そのプロセスを説明可能かつレビュー可能に保ちます。

Dreaming が書き込む内容

  • memory/.dreams/ のマシン状態（リコールストア、フェーズシグナル、取り込みチェックポイント、ロック）。
  • DREAMS.md（または既存の dreams.md）の人間が読める出力と、必要に応じて memory/dreaming/<phase>/YYYY-MM-DD.md 配下のフェーズレポートファイル。

長期昇格で引き続き書き込まれるのは MEMORY.md のみです。

フェーズモデル

Dreaming は、スイープごとに light -> REM -> deep の3つの協調フェーズを順番に実行します。これらは内部実装フェーズであり、ユーザーが個別に設定するモードではありません。

フェーズ 目的 永続的な書き込み
Light 最近の短期素材を分類してステージングする なし
REM テーマや繰り返し現れるアイデアを振り返る なし
Deep 永続化候補をスコアリングして昇格する あり（MEMORY.md）
Light フェーズ
  • 最近の短期リコール状態、日次メモリファイル、および利用可能な場合は編集済みのセッショントランスクリプトを読み取ります。
  • シグナルを重複排除し、候補行をステージングします。
  • ストレージにインライン出力が含まれる場合、管理対象の ## Light Sleep ブロックを書き込みます。
  • 後続の deep ランキングで使用する強化シグナルを記録します。
  • MEMORY.md には書き込みません。
REM フェーズ
  • 最近の短期トレースからテーマと振り返りの要約を作成します。
  • ストレージにインライン出力が含まれる場合、管理対象の ## REM Sleep ブロックを書き込みます。
  • deep ランキングで使用する REM 強化シグナルを記録します。
  • MEMORY.md には書き込みません。
Deep フェーズ
  • 重み付きスコアリングとしきい値ゲートで候補をランク付けします（minScore、minRecallCount、minUniqueQueries のすべてを通過する必要があります）。
  • 書き込み前に現在の日次ファイルからスニペットを再取得するため、古くなったスニペットや削除済みのスニペットはスキップされます。
  • 昇格したエントリを MEMORY.md に追記します。
  • ## Deep Sleep の要約を DREAMS.md に書き込み、必要に応じて memory/dreaming/deep/YYYY-MM-DD.md にも書き込みます。

セッショントランスクリプトの取り込み

Dreaming は、編集済みのセッショントランスクリプトを Dreaming コーパスに取り込めます。利用可能な場合、トランスクリプトは日次メモリシグナルやリコールトレースとともに light フェーズへ入力されます。個人的な内容や機密性の高い内容は、取り込み前に編集されます。

Dream Diary

Dreaming は、DREAMS.md に物語形式の Dream Diary を保持します。各フェーズに十分な素材が集まると、memory-core はベストエフォート方式のバックグラウンドサブエージェントターンを実行し、短い日記エントリを追記します。dreaming.model が設定されていない場合は、デフォルトのランタイムモデルを使用します。設定されたモデルが利用できない場合、日記の実行はセッションのデフォルトモデルで1回再試行されます。信頼または許可リストのエラーは再試行されず、汎用的な日記エントリへ暗黙的にフォールバックする代わりに、ログ上で確認できる状態のままになります。

レビューおよび復旧作業向けに、根拠に基づく履歴バックフィルレーンもあります。

バックフィルコマンド
  • memory rem-harness --path ... --grounded は、過去の YYYY-MM-DD.md ノートから根拠に基づく日記出力をプレビューします。
  • memory rem-backfill --path ... は、元に戻せる根拠に基づく日記エントリを DREAMS.md に書き込みます。
  • memory rem-backfill --path ... --stage-short-term は、根拠に基づく永続化候補を、通常の deep フェーズが使用するものと同じ短期エビデンスストアにステージングします。
  • memory rem-backfill --rollback と --rollback-short-term は、通常の日記エントリや現在の短期リコールに触れることなく、ステージングされたバックフィル成果物を削除します。

Control UI では、エージェントの Memory タブ（Agents ページ）に同じ日記のバックフィル／リセットフローが用意されています。これにより、根拠に基づく候補を昇格させる価値があるか判断する前に、ドリームシーンで結果を確認できます。独立した根拠付き Scene レーンには、過去のリプレイに由来するステージング済み短期エントリと、根拠に基づく情報が主導した昇格項目が表示されます。また、現在の短期状態に触れることなく、根拠に基づくものだけのステージング済みエントリを消去できます。

Deep ランキングシグナル

Deep ランキングでは、6つの重み付き基本シグナルとフェーズ強化を使用します。

シグナル 重み 説明
関連性 0.30 エントリの平均取得品質
頻度 0.24 エントリに蓄積された短期シグナルの数
クエリの多様性 0.15 エントリが現れた個別のクエリ／日コンテキスト
新しさ 0.15 時間減衰を適用した鮮度スコア
統合度 0.10 複数日にわたる再出現の強度
概念的な豊かさ 0.06 スニペット／パスに含まれる概念タグの密度

Light および REM フェーズでのヒットは、memory/.dreams/phase-signals.json から新しさに応じて減衰する小さなブーストを追加します。

シャドウトライアルの結果は、永続的な書き込みを行う前のレビューシグナルとして基本スコアに重ねられます。有用なトライアルは候補に小さな上限付きブーストを与え、中立的なトライアルは候補を保留のままにし、有害なトライアルはそのスコアリング処理で候補を却下済みとしてマークします。このシグナルはレポート専用です。候補の順序やレビューメタデータを変更することはありますが、MEMORY.md への書き込みや、単独での候補昇格は行いません。

QA シャドウトライアルレポートのカバレッジ

QA Lab には、将来の Dreaming シャドウトライアルが昇格前に候補メモリをレビューする方法を検討するための、レポート専用シナリオが含まれています。エージェントはベースラインの回答と候補メモリを使用可能な回答を比較し、判定、理由、リスクフラグを含むローカルレポートを書き込みます。このカバレッジは QA の範囲に限定されます。レポート成果物が MEMORY.md から分離されたままであることと、エージェントが候補を昇格済みだと主張しないことを検証します。本番環境のシャドウトライアル動作を追加したり、deep フェーズの昇格エンジンを変更したりするものではありません。

memory-core シャドウトライアルランナーは、安定した成果物を必要とするコードパス向けに、同じレポート専用契約を維持します。候補、トライアルプロンプト、ベースライン結果、候補使用時の結果、判定、理由、リスクフラグ、エビデンス参照を受け取り、promotion action: report-only を使用してレポートを書き込みます。有用という判定は promote の推奨に、中立という判定は defer に、有害という判定は reject にマッピングされます。いずれも MEMORY.md への書き込みや deep フェーズの昇格適用は行いません。

スケジュール

有効にすると、memory-core は Dreaming の完全なスイープ用に1つの Cron ジョブを自動管理します。プライマリランタイムワークスペースと設定済みのすべてのエージェントワークスペース間で重複排除されるため、サブエージェントのワークスペース展開によってメインエージェントの DREAMS.md とメモリ状態が除外されることはありません。

設定 デフォルト
dreaming.frequency 0 3 * * *
dreaming.model デフォルトモデル

クイックスタート

Dreaming を有効にする

json
{  "plugins": {    "entries": {      "memory-core": {        "config": {          "dreaming": {            "enabled": true          }        }      }    }  }}

カスタムスイープ間隔

json
{  "plugins": {    "entries": {      "memory-core": {        "config": {          "dreaming": {            "enabled": true,            "timezone": "America/Los_Angeles",            "frequency": "0 */6 * * *"          }        }      }    }  }}

スラッシュコマンド

text
/dreaming status/dreaming on/dreaming off/dreaming help

/dreaming on と /dreaming off では、チャネルからの呼び出し元には所有者ステータスが、Gateway クライアントには operator.admin が必要です。/dreaming status と /dreaming help は読み取り専用です。

CLI ワークフロー

昇格のプレビュー／適用

bash
openclaw memory promoteopenclaw memory promote --applyopenclaw memory promote --limit 5openclaw memory status --deep

手動の memory promote では、CLI フラグで上書きしない限り、デフォルトで deep フェーズのしきい値が使用されます。

昇格の説明

特定の候補が昇格する、または昇格しない理由を説明します。

bash
openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --json

REM ハーネスのプレビュー

何も書き込まずに、REM の振り返り、候補となる事実、deep 昇格の出力をプレビューします。

bash
openclaw memory rem-harnessopenclaw memory rem-harness --json

主要なデフォルト

すべての設定は plugins.entries.memory-core.config.dreaming 配下にあります。

enabledbooleandefault: false

Dreaming スイープを有効または無効にします。

frequencystringdefault: 0 3 * * *

Dreaming の完全なスイープを実行する Cron 間隔です。

modelstring

Dream Diary サブエージェントモデルのオプションの上書きです。サブエージェントの allowedModels 許可リストも設定する場合は、正規の provider/model 値を使用します。

phases.deep.maxPromotedSnippetTokensnumberdefault: 160

MEMORY.md に昇格する各短期リコールスニペットから保持される推定トークン数の上限です。ランキングの出所情報は引き続き確認できます。

Dreams UI

有効にすると、Gateway の Dreams タブには次の内容が表示されます。

  • 現在の Dreaming 有効状態
  • フェーズ単位のステータスと管理対象スイープの有無
  • 短期、根拠付き、シグナル、本日昇格済みの各件数
  • 次回のスケジュール実行時刻
  • ステージングされた履歴リプレイエントリ用の独立した根拠付き Scene レーン
  • doctor.memory.dreamDiary をデータソースとする展開可能な Dream Diary リーダー

関連項目

Was this useful?
On this page

On this page