メモリの概要

OpenClaw は、エージェントのワークスペースに プレーンな Markdown ファイルを書き込むことで情報を記憶します。モデルが「記憶」するのはディスクに保存された内容だけです。隠れた状態はありません。

仕組み

エージェントには、メモリ関連のファイルが 3 つあります。

• MEMORY.md — 長期メモリ。永続的な事実、好み、判断。すべての DM セッションの開始時に読み込まれます。
• memory/YYYY-MM-DD.md — 日次ノート。進行中のコンテキストと観察事項。今日と昨日のノートは自動的に読み込まれます。
• DREAMS.md（任意）— Dream Diary と Dreaming スイープの概要。根拠に基づく履歴バックフィル項目を含め、人間によるレビューのために使います。

これらのファイルはエージェントワークスペース（デフォルトは ~/.openclaw/workspace）にあります。

何をどこに置くか

MEMORY.md は、コンパクトで精選された層です。永続的な事実、好み、継続的な判断、メインのプライベートセッション開始時に利用できるべき短い要約に使います。これは生のトランスクリプト、日次ログ、網羅的なアーカイブとして使うものではありません。

memory/YYYY-MM-DD.md ファイルは作業用の層です。詳細な日次ノート、観察事項、セッション要約、後でまだ役立つ可能性がある生のコンテキストに使います。これらのファイルは memory_search と memory_get 用にインデックス化されますが、通常のブートストラッププロンプトに毎ターン注入されるわけではありません。

時間が経つにつれて、エージェントは日次ノートから有用な内容を MEMORY.md に抽出し、古くなった長期項目を削除することが期待されます。生成されたワークスペース指示と Heartbeat フローは、これを定期的に実行できます。記憶させる詳細ごとに手動で MEMORY.md を編集する必要はありません。

MEMORY.md がブートストラップファイルの予算を超えると、OpenClaw はディスク上のファイルをそのまま保持しますが、モデルコンテキストに注入するコピーは切り詰めます。これは、詳細な内容を memory/*.md に戻し、MEMORY.md には永続的な要約だけを残すか、明示的により多くのプロンプト予算を使いたい場合はブートストラップ上限を引き上げる合図として扱ってください。生のサイズと注入サイズ、および切り詰め状態を確認するには、/context list、/context detail、または openclaw doctor を使います。

推論されたコミットメント

将来のフォローアップの中には、永続的な事実ではないものがあります。明日の面接について言及した場合、有用なメモリは「面接後に確認する」であって、「これを MEMORY.md に永遠に保存する」ではないかもしれません。

コミットメントは、そのような場合のための、オプトインで短期的なフォローアップメモリです。OpenClaw はこれを隠れたバックグラウンド処理で推論し、同じエージェントとチャンネルにスコープし、期限が来た確認を Heartbeat 経由で届けます。明示的なリマインダーには引き続きスケジュール済みタスクを使います。

メモリツール

エージェントには、メモリを扱うためのツールが 2 つあります。

• memory_search — 元の表現と文言が異なる場合でも、セマンティック検索を使って関連するノートを見つけます。
• memory_get — 特定のメモリファイルまたは行範囲を読み取ります。

どちらのツールも、アクティブなメモリPlugin（デフォルト: memory-core）によって提供されます。

Memory Wiki コンパニオンPlugin

永続メモリを単なる生ノートではなく、保守されたナレッジベースのように振る舞わせたい場合は、バンドルされている memory-wiki Pluginを使います。

memory-wiki は、永続的な知識を次の要素を持つ Wiki Vault にコンパイルします。

• 決定論的なページ構造
• 構造化された主張と証拠
• 矛盾と鮮度の追跡
• 生成されたダッシュボード
• エージェント/ランタイム利用者向けのコンパイル済みダイジェスト
• wiki_search、wiki_get、wiki_apply、wiki_lint などの Wiki ネイティブツール

これはアクティブなメモリPluginを置き換えるものではありません。アクティブなメモリPluginは引き続き、想起、昇格、Dreaming を所有します。memory-wiki は、その横に来歴が豊富な知識層を追加します。

Memory Wikiを参照してください。

メモリ検索

埋め込みプロバイダーが設定されている場合、memory_search は ハイブリッド検索を使います。これは、ベクトル類似度（意味的な近さ）とキーワードマッチング（ID やコードシンボルのような正確な語）を組み合わせるものです。対応プロバイダーの API キーがあれば、すぐに動作します。

検索の仕組み、調整オプション、プロバイダー設定の詳細については、メモリ検索を参照してください。

メモリバックエンド

ナレッジ Wiki 層

自動メモリフラッシュ

Compaction が会話を要約する前に、OpenClaw は重要なコンテキストをメモリファイルに保存するようエージェントに促すサイレントターンを実行します。これはデフォルトで有効です。何も設定する必要はありません。

そのハウスキーピングターンをローカルモデルで実行し続けるには、正確なメモリフラッシュモデルのオーバーライドを設定します。

{  "agents": {    "defaults": {      "compaction": {        "memoryFlush": {          "model": "ollama/qwen3:8b"        }      }    }  }}

このオーバーライドはメモリフラッシュターンにのみ適用され、アクティブセッションのフォールバックチェーンを継承しません。

Dreaming

Dreaming は、メモリのための任意のバックグラウンド統合処理です。短期的なシグナルを収集し、候補をスコアリングし、条件を満たした項目だけを長期メモリ（MEMORY.md）に昇格します。

長期メモリのシグナル品質を高く保つよう設計されています。

• オプトイン: デフォルトでは無効です。
• スケジュール済み: 有効にすると、memory-core が完全な Dreaming スイープ用に 1 つの繰り返し Cron ジョブを自動管理します。
• しきい値付き: 昇格は、スコア、想起頻度、クエリ多様性のゲートを通過する必要があります。
• レビュー可能: フェーズ概要と日誌項目は、人間によるレビューのため DREAMS.md に書き込まれます。

フェーズ動作、スコアリングシグナル、Dream Diary の詳細については、Dreamingを参照してください。

根拠付きバックフィルとライブ昇格

Dreaming システムには、現在 2 つの密接に関連するレビューレーンがあります。

• ライブ Dreaming は、memory/.dreams/ 配下の短期 Dreaming ストアを使います。通常のディープフェーズが何を MEMORY.md に昇格できるかを判断するときに使うものです。
• 根拠付きバックフィル は、履歴の memory/YYYY-MM-DD.md ノートを独立した日次ファイルとして読み取り、構造化されたレビュー出力を DREAMS.md に書き込みます。

根拠付きバックフィルは、古いノートを再生し、MEMORY.md を手動編集せずに、システムが何を永続的だと判断するかを確認したい場合に役立ちます。

次を使う場合:

openclaw memory rem-backfill --path ./memory --stage-short-term

根拠付きの永続候補は直接昇格されません。通常のディープフェーズがすでに使っているものと同じ短期 Dreaming ストアにステージングされます。つまり:

• DREAMS.md は人間向けのレビュー面のままです。
• 短期ストアは機械向けのランキング面のままです。
• MEMORY.md は引き続きディープ昇格によってのみ書き込まれます。

再生が有用でなかったと判断した場合は、通常の日誌項目や通常の想起状態に触れずに、ステージングされた成果物を削除できます。

openclaw memory rem-backfill --rollbackopenclaw memory rem-backfill --rollback-short-term

CLI

openclaw memory status          # インデックス状態とプロバイダーを確認するopenclaw memory search "query"  # コマンドラインから検索するopenclaw memory index --force   # インデックスを再構築する

関連資料

• 組み込みメモリエンジン: デフォルトの SQLite バックエンド。
• QMD メモリエンジン: 高度なローカル優先サイドカー。
• Honcho メモリ: AI ネイティブなクロスセッションメモリ。
• Memory LanceDB: OpenAI 互換の埋め込みを備えた LanceDB バックエンドPlugin。
• Memory Wiki: コンパイル済みナレッジ Vault と Wiki ネイティブツール。
• メモリ検索: 検索パイプライン、プロバイダー、調整。
• Dreaming: 短期想起から長期メモリへのバックグラウンド昇格。
• メモリ設定リファレンス: すべての設定項目。
• Compaction: Compaction がメモリとどのように相互作用するか。

関連

• Active Memory
• メモリ検索
• 組み込みメモリエンジン
• Honcho メモリ
• Memory LanceDB
• コミットメント