openclaw memory
セマンティックメモリのインデックス作成、検索、および MEMORY.md への昇格を管理します。
バンドルされている memory-core Plugin によって提供され、
plugins.slots.memory で memory-core（デフォルト）が選択されている場合に利用できます。その他のメモリ
Plugin は、それぞれ独自の CLI 名前空間を公開します。
関連項目: メモリの概念、Dreaming、
メモリ設定リファレンス、メモリ Wiki、
Wiki、Plugin。
memory status
--agent を指定しない場合、agents.entries 内のすべてのエージェントに対して実行されます。エージェントリストが
設定されていない場合は、デフォルトのエージェントにフォールバックします。
dreaming.enabled: true を指定しても Dreaming 行が off のままである場合、または
スケジュールされたスイープがまったく実行されていないように見える場合、管理対象の Dreaming Cron は、
調整をトリガーするデフォルトエージェントの Heartbeat の発火に依存しています。スケジュールの詳細については、
Dreamingを参照してください。
ステータスには、memory.search.extraPaths の追加検索パスも表示されます。
memory index
status と同じです。--force は、増分再インデックスではなく
完全な再インデックスを実行します。--verbose は、インデックス作成の進行状況を表示する前に、エージェントごとのプロバイダー、モデル、ソース、および
追加パスの詳細を出力します。
memory search
- クエリ: 位置引数
[query]または--query <text>。両方が設定されている場合は、--queryが優先されます。どちらも設定されていない場合、コマンドはエラーになります。 --agent <id>: デフォルトでは、エージェントリスト全体ではなくデフォルトのエージェントを使用します。--max-results <n>: 結果数を制限します（正の整数）。--min-score <n>: このスコア未満の一致を除外します。
memory promote
memory/YYYY-MM-DD.md の短期候補をランク付けし、必要に応じて上位のエントリを
MEMORY.md に追記します。
これらの CLI のデフォルトは、スケジュールされた Dreaming スイープの深層フェーズの
しきい値とは異なります（下記のDreamingを参照）。一度限りの手動実行で
スイープの動作に合わせるには、明示的なフラグを渡してください。
ランキングシグナルには、リコール頻度、取得関連性、クエリの多様性、
時間的な新しさ、日をまたぐ統合、および派生概念の豊富さが含まれ、これらは
メモリのリコールと日次取り込みパスの両方から取得されます。さらに、Dreaming で繰り返し再訪された項目には、
ライト／REM フェーズによる強化ブーストがわずかに加わります。書き込み前に、昇格処理は
現在の日次ノートを再読み込みするため、ランキング後に短期スニペットが編集または削除されていても、
古いスナップショットから昇格することなく、その変更が反映されます。
memory promote-explain
1 件の昇格候補について、スコアの内訳を説明します。
<selector> は、候補のキー（完全一致または部分文字列）、パス、またはスニペット
テキストと照合します。
memory rem-harness
何も書き込まずに、REM の振り返り、真実の候補、および深層フェーズの昇格出力を
プレビューします。
--path <file-or-dir>: 現在のワークスペースではなく、過去のYYYY-MM-DD.md日次ファイルからハーネスを初期化します。--grounded: 過去のノートから、根拠に基づくWhat Happened／Reflections／Possible Lasting Updatesのプレビューもレンダリングします。
memory rem-backfill
UI で確認できるよう、根拠に基づく過去の REM 要約を DREAMS.md に書き込みます。
元に戻せます。
--path <file-or-dir>:--rollback／--rollback-short-termが設定されていない限り必須です。バックフィル元となる過去の日次メモリファイル、またはディレクトリです。--stage-short-term: 根拠に基づく永続的な候補を現在の 短期昇格ストアにも初期投入し、通常の深層フェーズでランク付けできるようにします。--rollback: 以前に書き込まれた、根拠に基づく日記エントリをDREAMS.mdから削除します。--rollback-short-term: 以前にステージングされた、根拠に基づく短期 候補を削除します。
Dreaming
Dreaming は、1 つのスケジュール上で順番に実行される 3 つの協調 フェーズを備えたバックグラウンドのメモリ統合システムです。ライト（短期 素材の整理／ステージング）、REM（振り返りとテーマの抽出）、深層（永続的な 事実をMEMORY.md に昇格）。MEMORY.md に書き込むのは深層フェーズだけです。
plugins.entries.memory-core.config.dreaming.enabled: trueで有効にします （デフォルトはfalse）。memory-coreはスイープの Cron ジョブを自動管理するため、手動でopenclaw cron addを設定する必要はありません。- チャットから
/dreaming on|offで切り替え、/dreaming status（または/dreaming／/dreaming help）で確認します。on／offには、チャンネル所有者のステータス または Gateway のoperator.adminが必要です。statusとヘルプは、コマンドを 実行できるすべてのユーザーが引き続き利用できます。 - 人が読める形式のフェーズ出力は、
DREAMS.md（または既存のdreams.md）に送られます。 デフォルト（dreaming.storage.mode: "separate"）では、各フェーズは 個別のレポートもmemory/dreaming/<phase>/YYYY-MM-DD.mdに書き込みます。レポートを日次メモリファイルに統合するにはmode: "inline"を、両方に出力するには"both"を設定します。 - スケジュール実行と手動の
memory promote実行では、同じ深層フェーズの ランキングシグナルを共有します。異なるのはデフォルトのしきい値だけです（上記の表と 下記のスケジュール時のデフォルトを参照）。 - スケジュール実行は、設定されたすべてのエージェントのメモリワークスペースに分散して実行されます。
plugins.entries.memory-core.config.dreaming）:
SecretRef の Gateway 依存関係
Active Memory のリモート API キーフィールドが SecretRef として設定されている場合、memory
コマンドはアクティブな Gateway スナップショットからそれらを解決します。Gateway が
利用できない場合、コマンドは即座に失敗します。これには、secrets.resolve
メソッドをサポートする Gateway が必要です。古い Gateway は不明なメソッドのエラーを返します。