メモリの概要
OpenClawは、エージェントのワークスペース内にプレーンなMarkdownファイルを書き込むことで物事を記憶します。モデルが「記憶」するのは、ディスクに保存された内容だけです。隠れた状態はありません。仕組み
エージェントには、メモリに関連する3つのファイルがあります。MEMORY.md— 長期メモリ。永続的な事実、設定、決定事項。すべてのDMセッションの開始時に読み込まれます。memory/YYYY-MM-DD.md— 日次ノート。継続中のコンテキストと観察結果。今日と昨日のノートは自動的に読み込まれます。DREAMS.md(任意) — 人間が確認するためのDream DiaryとDreamingスイープの要約。根拠のある履歴バックフィルのエントリも含まれます。
~/.openclaw/workspace）。
メモリツール
エージェントには、メモリを扱うための2つのツールがあります。memory_search— 元の表現と異なっていても、セマンティック検索を使って関連ノートを見つけます。memory_get— 特定のメモリファイルまたは行範囲を読み取ります。
memory-core）によって提供されます。
Memory WikiコンパニオンPlugin
永続メモリを単なる生ノートではなく、保守されたナレッジベースのように振る舞わせたい場合は、バンドルされているmemory-wiki Pluginを使ってください。
memory-wikiは、永続的な知識を次の要素を備えたwiki vaultにコンパイルします。
- 決定論的なページ構造
- 構造化された主張と証拠
- 矛盾と鮮度の追跡
- 生成されるダッシュボード
- エージェント/ランタイム利用者向けのコンパイル済みダイジェスト
wiki_search、wiki_get、wiki_apply、wiki_lintのようなwikiネイティブツール
memory-wikiは、その隣に来歴情報が豊富な知識レイヤーを追加します。
詳しくはMemory Wikiを参照してください。
メモリ検索
埋め込みプロバイダーが設定されている場合、memory_searchはハイブリッド検索を使用します。これは、ベクトル類似性（意味的な近さ）とキーワード一致（IDやコードシンボルのような正確な用語）を組み合わせる方式です。サポートされている任意のプロバイダーのAPIキーがあれば、すぐに利用できます。
OpenClawは、利用可能なAPIキーから埋め込みプロバイダーを自動検出します。OpenAI、Gemini、Voyage、またはMistralのキーが設定されていれば、メモリ検索は自動的に有効になります。
メモリバックエンド
組み込み（デフォルト）
SQLiteベース。キーワード検索、ベクトル類似性、ハイブリッド検索がそのまま使えます。追加の依存関係はありません。
QMD
ローカルファーストのサイドカーで、再ランキング、クエリ拡張、ワークスペース外のディレクトリをインデックスできる機能を備えています。
Honcho
ユーザーモデリング、セマンティック検索、マルチエージェント認識を備えた、AIネイティブなセッション横断メモリ。Pluginをインストールします。
ナレッジwikiレイヤー
Memory Wiki
永続メモリを、主張、ダッシュボード、ブリッジモード、Obsidian互換ワークフローを備えた、来歴情報が豊富なwiki vaultにコンパイルします。
自動メモリフラッシュ
Compactionが会話を要約する前に、OpenClawは重要なコンテキストをメモリファイルに保存するようエージェントに促すサイレントターンを実行します。これはデフォルトで有効になっており、何か設定する必要はありません。Dreaming
Dreamingは、メモリのための任意のバックグラウンド統合パスです。短期シグナルを収集し、候補をスコアリングし、適格な項目だけを長期メモリ（MEMORY.md）へ昇格させます。
これは、長期メモリのシグナル密度を高く保つよう設計されています。
- オプトイン: デフォルトでは無効です。
- スケジュール実行: 有効にすると、
memory-coreは完全なDreamingスイープ用の定期的なCronジョブを1つ自動管理します。 - しきい値判定: 昇格には、スコア、想起頻度、クエリ多様性の各ゲートを通過する必要があります。
- レビュー可能: フェーズ要約と日誌エントリは、人間が確認できるよう
DREAMS.mdに書き込まれます。
根拠のあるバックフィルとライブ昇格
Dreamingシステムには、現在2つの密接に関連したレビュー経路があります。- ライブDreamingは、
memory/.dreams/配下の短期Dreamingストアを使って動作し、通常のディープフェーズが何をMEMORY.mdへ昇格できるか判断する際に使われます。 - 根拠のあるバックフィルは、過去の
memory/YYYY-MM-DD.mdノートを独立した日次ファイルとして読み取り、構造化されたレビュー出力をDREAMS.mdに書き込みます。
MEMORY.mdを手動編集せずに確認したい場合に便利です。
次のように使用した場合:
DREAMS.mdは引き続き人間向けのレビュー画面です。- 短期ストアは引き続きマシン向けのランキング画面です。
MEMORY.mdには引き続きディープ昇格によってのみ書き込まれます。
CLI
さらに読む
- Builtin Memory Engine — デフォルトのSQLiteバックエンド
- QMD Memory Engine — 高度なローカルファーストのサイドカー
- Honcho Memory — AIネイティブなセッション横断メモリ
- Memory Wiki — コンパイル済みナレッジvaultとwikiネイティブツール
- Memory Search — 検索パイプライン、プロバイダー、調整
- Dreaming — 短期想起から長期メモリへのバックグラウンド昇格
- Memory configuration reference — すべての設定項目
- Compaction — Compactionがメモリとどう相互作用するか