openclaw memory
セマンティックメモリのインデックス作成、検索、MEMORY.md への昇格を管理します。
同梱の memory-core Plugin によって提供され、plugins.slots.memory が
memory-core を選択している場合に利用できます（デフォルト）。他のメモリ
Plugin はそれぞれ独自の CLI 名前空間を公開します。
関連: Memory の概念、Dreaming、
Memory 設定リファレンス、Memory Wiki、
wiki、Plugins。
memory status
--agent を指定しない場合、agents.list 内のすべてのエージェントに対して実行します。エージェントリストが
設定されていない場合は、デフォルトエージェントにフォールバックします。
| フラグ | 効果 |
|---|---|
--deep | ベクトルストア、埋め込みプロバイダー、セマンティック検索の準備状態を調査します（追加のプロバイダー呼び出しを伴います）。通常の memory status は高速なままで、これをスキップします。不明なベクトル/セマンティック状態は、調査されていないことを意味します。QMD の字句 searchMode: "search" は、--deep があっても常にセマンティックベクトル調査をスキップします。 |
--index | ストアが dirty な場合に再インデックスします。--deep を含意します。 |
--fix | 古い recall ロックを修復し、昇格メタデータを正規化します。 |
--json | JSON を出力します。 |
--verbose | フェーズごとの詳細ログを出力します。 |
dreaming.enabled: true でも Dreaming 行が off のままの場合、または
スケジュールされた sweep が実行されていないように見える場合、管理対象の dreaming cron は
調整をトリガーするためにデフォルトエージェントの Heartbeat 発火に依存しています。
スケジュールの詳細は Dreaming を参照してください。
ステータスには、agents.defaults.memorySearch.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 に追記します。
| フラグ | デフォルト | 効果 |
|---|---|---|
--limit <n> | 返す/適用する候補の最大数。 | |
--min-score <n> | 0.75 | 重み付き昇格スコアの最小値。 |
--min-recall-count <n> | 3 | 必要な最小 recall 回数。 |
--min-unique-queries <n> | 2 | 必要な最小の個別クエリ数。 |
--apply | プレビューのみ | 選択した候補を MEMORY.md に追記し、昇格済みにします。 |
--include-promoted | 以前のサイクルですでに昇格された候補を含めます。 | |
--json | JSON を出力します。 |
memory promote-explain
1 つの昇格候補のスコア内訳を説明します。
<selector> は、候補のキー（完全一致または部分文字列）、パス、またはスニペット
テキストに一致します。
memory rem-harness
何も書き込まずに、REM の振り返り、候補 truth、deep フェーズの昇格出力を
プレビューします。
--path <file-or-dir>: ライブワークスペースの代わりに、過去のYYYY-MM-DD.md日次ファイルからハーネスに seed します。--grounded: 過去のノートから grounded なWhat Happened/Reflections/Possible Lasting Updatesプレビューもレンダリングします。
memory rem-backfill
UI レビュー用に、grounded な過去の REM サマリーを DREAMS.md に書き込みます。
元に戻せます。
--path <file-or-dir>:--rollback/--rollback-short-termが設定されていない限り必須です。 バックフィル元の過去の日次メモリファイル、またはディレクトリです。--stage-short-term: grounded な durable 候補もライブの 短期昇格ストアに seed し、通常の deep フェーズでランク付けできるようにします。--rollback: 以前に書き込まれた grounded な日記エントリをDREAMS.mdから削除します。--rollback-short-term: 以前にステージングされた grounded な短期 候補を削除します。
Dreaming
Dreaming はバックグラウンドのメモリ統合システムで、3 つの協調 フェーズを 1 つのスケジュールで順番に実行します: light（短期 素材の整理/ステージング）、REM（振り返りとテーマの表出）、deep（durable な 事実をMEMORY.md に昇格）。MEMORY.md に書き込むのは deep のみです。
plugins.entries.memory-core.config.dreaming.enabled: trueで有効化します （デフォルトはfalse）。memory-coreは sweep cron ジョブを自動管理するため、手動でopenclaw cron addする必要はありません。- チャットから
/dreaming on|offで切り替えます。/dreaming status（または/dreaming//dreaming help）で確認します。on/offにはチャンネル所有者ステータス または Gatewayoperator.adminが必要です。statusとヘルプは、コマンドを呼び出せる人なら誰でも 利用できます。 - 人間が読めるフェーズ出力は
DREAMS.md（または既存のdreams.md）に出力されます。 デフォルト（dreaming.storage.mode: "separate"）では、各フェーズは スタンドアロンのレポートもmemory/dreaming/<phase>/YYYY-MM-DD.mdに書き込みます。代わりに日次メモリファイルへレポートを畳み込むにはmode: "inline"を設定し、両方に出力するには"both"を設定します。 - スケジュール実行と手動の
memory promote実行は、同じ deep フェーズの ランキングシグナルを共有します。異なるのはデフォルトしきい値のみです（上の表と 下のスケジュール既定値を比較してください）。 - スケジュール実行は、設定済みのすべてのエージェントのメモリワークスペースにファンアウトします。
plugins.entries.memory-core.config.dreaming）:
| キー | デフォルト |
|---|---|
frequency | 0 3 * * * |
phases.deep.minScore | 0.8 |
phases.deep.minRecallCount | 3 |
phases.deep.minUniqueQueries | 3 |
phases.deep.recencyHalfLifeDays | 14 |
phases.deep.maxAgeDays | 30 |
phases.deep.maxPromotedSnippetTokens | 160 |
SecretRef Gateway 依存関係
Active Memory のリモート API キーフィールドが SecretRefs として設定されている場合、memory
コマンドはアクティブな Gateway スナップショットからそれらを解決します。Gateway が
利用できない場合、コマンドは即座に失敗します。これには
secrets.resolve メソッドをサポートする Gateway が必要です。古い Gateway は unknown-method エラーを返します。