openclaw memory

セマンティックメモリのインデックス作成と検索を管理します。 バンドルされた memory-core Plugin によって提供されます。このコマンドは plugins.slots.memory が memory-core を選択している場合（デフォルト）に利用できます。他のメモリ Plugin は 独自の CLI 名前空間を公開します。

関連:

• メモリの概念: メモリ
• メモリ Wiki: メモリ Wiki
• Wiki CLI: wiki
• Plugin: Plugin

例

openclaw memory statusopenclaw memory status --deepopenclaw memory status --fixopenclaw memory index --forceopenclaw memory search "meeting notes"openclaw memory search --query "deployment" --max-results 20openclaw memory promote --limit 10 --min-score 0.75openclaw memory promote --applyopenclaw memory promote --json --min-recall-count 0 --min-unique-queries 0openclaw memory promote-explain "router vlan"openclaw memory promote-explain "router vlan" --jsonopenclaw memory rem-harnessopenclaw memory rem-harness --jsonopenclaw memory status --jsonopenclaw memory status --deep --indexopenclaw memory status --deep --index --verboseopenclaw memory status --agent mainopenclaw memory index --agent main --verbose

オプション

memory status と memory index:

• --agent <id>: 単一のエージェントにスコープを限定します。指定しない場合、これらのコマンドは構成済みの各エージェントに対して実行されます。エージェントリストが構成されていない場合は、デフォルトエージェントにフォールバックします。
• --verbose: プローブとインデックス作成中に詳細ログを出力します。

memory status:

• --deep: ローカルベクトルストアの準備状態、埋め込みプロバイダーの準備状態、セマンティックベクトル検索の準備状態をプローブします。通常の memory status は高速に保たれ、ライブ埋め込みやプロバイダー検出処理を実行しません。不明なベクトルストア状態またはセマンティックベクトル状態は、そのコマンドでプローブされなかったことを意味します。QMD の字句 searchMode: "search" は、--deep を指定していてもセマンティックベクトルプローブと埋め込みメンテナンスをスキップします。
• --index: ストアが dirty の場合に再インデックスを実行します（--deep を含意します）。
• --fix: 古いリコールロックを修復し、プロモーションメタデータを正規化します。
• --json: JSON 出力を表示します。

memory status に Dreaming status: blocked と表示される場合、管理対象の Dreaming Cron は有効ですが、それを駆動する Heartbeat がデフォルトエージェントで発火していません。一般的な 2 つの原因については、Dreaming が実行されないを参照してください。

memory index:

• --force: 完全な再インデックスを強制します。

memory search:

• クエリ入力: 位置引数 [query] または --query <text> のどちらかを渡します。
• 両方が指定された場合、--query が優先されます。
• どちらも指定されない場合、コマンドはエラーで終了します。
• --agent <id>: 単一のエージェントにスコープを限定します（デフォルト: デフォルトエージェント）。
• --max-results <n>: 返す結果数を制限します。
• --min-score <n>: 低スコアの一致を除外します。
• --json: JSON 結果を表示します。

memory promote:

短期メモリのプロモーションをプレビューして適用します。

openclaw memory promote [--apply] [--limit <n>] [--include-promoted]

• --apply -- プロモーションを MEMORY.md に書き込みます（デフォルト: プレビューのみ）。
• --limit <n> -- 表示する候補数の上限を設定します。
• --include-promoted -- 以前のサイクルですでにプロモートされたエントリを含めます。

全オプション:

• 加重プロモーションシグナル（frequency、relevance、query diversity、recency、consolidation、conceptual richness）を使用して、memory/YYYY-MM-DD.md から短期候補をランク付けします。
• メモリリコールと日次取り込みパスの両方からの短期シグナルに加え、light/REM フェーズの強化シグナルを使用します。
• Dreaming が有効な場合、memory-core はバックグラウンドで完全スイープ（light -> REM -> deep）を実行する 1 つの Cron ジョブを自動管理します（手動の openclaw cron add は不要です）。
• --agent <id>: 単一のエージェントにスコープを限定します（デフォルト: デフォルトエージェント）。
• --limit <n>: 返す/適用する候補の最大数。
• --min-score <n>: 最小の加重プロモーションスコア。
• --min-recall-count <n>: 候補に必要な最小リコール回数。
• --min-unique-queries <n>: 候補に必要な最小の distinct クエリ数。
• --apply: 選択された候補を MEMORY.md に追記し、プロモート済みとしてマークします。
• --include-promoted: すでにプロモートされた候補を出力に含めます。
• --json: JSON 出力を表示します。

memory promote-explain:

特定のプロモーション候補と、そのスコア内訳を説明します。

openclaw memory promote-explain <selector> [--agent <id>] [--include-promoted] [--json]

• <selector>: 検索する候補キー、パス断片、またはスニペット断片。
• --agent <id>: 単一のエージェントにスコープを限定します（デフォルト: デフォルトエージェント）。
• --include-promoted: すでにプロモートされた候補を含めます。
• --json: JSON 出力を表示します。

memory rem-harness:

何も書き込まずに、REM の内省、候補 truth、deep プロモーション出力をプレビューします。

openclaw memory rem-harness [--agent <id>] [--include-promoted] [--json]

• --agent <id>: 単一のエージェントにスコープを限定します（デフォルト: デフォルトエージェント）。
• --include-promoted: すでにプロモートされた deep 候補を含めます。
• --json: JSON 出力を表示します。

Dreaming

Dreaming は、3 つの協調フェーズを持つバックグラウンドメモリ統合システムです: light（短期素材を整理/ステージング）、deep（永続的な fact を MEMORY.md にプロモート）、REM（内省してテーマを表面化）。

• plugins.entries.memory-core.config.dreaming.enabled: true で有効化します。
• チャットから /dreaming on|off で切り替えます（または /dreaming status で確認します）。 チャンネル呼び出し元が設定を変更するには owner である必要があります。Gateway クライアントには operator.admin が必要です。読み取り専用のステータスとヘルプは、認可された コマンド送信者が引き続き利用できます。
• Dreaming は 1 つの管理対象スイープスケジュール（dreaming.frequency）で実行され、フェーズを light、REM、deep の順に実行します。
• deep フェーズだけが永続メモリを MEMORY.md に書き込みます。
• 人間が読めるフェーズ出力と日記エントリは DREAMS.md（または既存の dreams.md）に書き込まれ、任意でフェーズごとのレポートが memory/dreaming/<phase>/YYYY-MM-DD.md に書き込まれます。
• ランキングには、リコール頻度、取得関連性、クエリ多様性、時間的な新しさ、日をまたぐ統合、派生概念の豊かさという加重シグナルを使用します。
• プロモーションは MEMORY.md に書き込む前にライブの日次ノートを再読み込みするため、編集または削除された短期スニペットが古いリコールストアのスナップショットからプロモートされることはありません。
• スケジュール実行と手動の memory promote 実行は、CLI しきい値オーバーライドを渡さない限り、同じ deep フェーズのデフォルトを共有します。
• 自動実行は、構成済みのメモリワークスペース全体にファンアウトします。

デフォルトのスケジュール:

• スイープ間隔: dreaming.frequency = 0 3 * * *
• Deep しきい値: minScore=0.8、minRecallCount=3、minUniqueQueries=3、recencyHalfLifeDays=14、maxAgeDays=30

例:

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

メモ:

• memory index --verbose は、フェーズごとの詳細（プロバイダー、モデル、ソース、バッチ活動）を表示します。
• memory status には、memorySearch.extraPaths 経由で構成された追加パスが含まれます。
• 実質的に有効な Active Memory リモート API キーフィールドが SecretRef として構成されている場合、コマンドはアクティブな Gateway スナップショットからそれらの値を解決します。Gateway が利用できない場合、コマンドは即座に失敗します。
• Gateway バージョンずれの注意: このコマンドパスには secrets.resolve をサポートする Gateway が必要です。古い Gateway は unknown-method エラーを返します。
• スケジュールされたスイープ間隔は dreaming.frequency で調整します。deep プロモーションポリシーは、それ以外では内部扱いです。ただし dreaming.phases.deep.maxPromotedSnippetTokens は例外で、provenance を見える状態に保ちながらプロモートされるスニペット長を制限します。一回限りの手動しきい値オーバーライドが必要な場合は、memory promote の CLI フラグを使用してください。
• memory rem-harness --path <file-or-dir> --grounded は、何も書き込まずに、過去の日次ノートから grounded な What Happened、Reflections、Possible Lasting Updates をプレビューします。
• memory rem-backfill --path <file-or-dir> は、UI レビュー用に reversible な grounded 日記エントリを DREAMS.md に書き込みます。
• memory rem-backfill --path <file-or-dir> --stage-short-term は、grounded な永続候補もライブの短期プロモーションストアにシードし、通常の deep フェーズがそれらをランク付けできるようにします。
• memory rem-backfill --rollback は以前に書き込まれた grounded 日記エントリを削除し、memory rem-backfill --rollback-short-term は以前にステージングされた grounded 短期候補を削除します。
• 完全なフェーズ説明と構成リファレンスについては、Dreamingを参照してください。

関連

• CLI リファレンス
• メモリ概要