OpenClaw は、エージェントのワークスペースに プレーンな Markdown ファイルを書き込むことで情報を記憶します。モデルが「記憶」するのはディスクに保存された内容だけです。隠れた状態はありません。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
仕組み
エージェントには、メモリ関連のファイルが 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— 特定のメモリファイルまたは行範囲を読み取ります。
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 インストールです。
LanceDB
OpenAI 互換の埋め込み、自動想起、自動キャプチャ、ローカル Ollama 埋め込み対応を備えた、バンドル済みの LanceDB バックエンドメモリです。
ナレッジ Wiki 層
Memory Wiki
主張、ダッシュボード、ブリッジモード、Obsidian に適したワークフローを備えた、来歴が豊富な Wiki Vault に永続メモリをコンパイルします。
自動メモリフラッシュ
Compaction が会話を要約する前に、OpenClaw は重要なコンテキストをメモリファイルに保存するようエージェントに促すサイレントターンを実行します。これはデフォルトで有効です。何も設定する必要はありません。 そのハウスキーピングターンをローカルモデルで実行し続けるには、正確なメモリフラッシュモデルのオーバーライドを設定します。Dreaming
Dreaming は、メモリのための任意のバックグラウンド統合処理です。短期的なシグナルを収集し、候補をスコアリングし、条件を満たした項目だけを長期メモリ（MEMORY.md）に昇格します。
長期メモリのシグナル品質を高く保つよう設計されています。
- オプトイン: デフォルトでは無効です。
- スケジュール済み: 有効にすると、
memory-coreが完全な Dreaming スイープ用に 1 つの繰り返し Cron ジョブを自動管理します。 - しきい値付き: 昇格は、スコア、想起頻度、クエリ多様性のゲートを通過する必要があります。
- レビュー可能: フェーズ概要と日誌項目は、人間によるレビューのため
DREAMS.mdに書き込まれます。
根拠付きバックフィルとライブ昇格
Dreaming システムには、現在 2 つの密接に関連するレビューレーンがあります。- ライブ Dreaming は、
memory/.dreams/配下の短期 Dreaming ストアを使います。通常のディープフェーズが何をMEMORY.mdに昇格できるかを判断するときに使うものです。 - 根拠付きバックフィル は、履歴の
memory/YYYY-MM-DD.mdノートを独立した日次ファイルとして読み取り、構造化されたレビュー出力をDREAMS.mdに書き込みます。
MEMORY.md を手動編集せずに、システムが何を永続的だと判断するかを確認したい場合に役立ちます。
次を使う場合:
DREAMS.mdは人間向けのレビュー面のままです。- 短期ストアは機械向けのランキング面のままです。
MEMORY.mdは引き続きディープ昇格によってのみ書き込まれます。
CLI
関連資料
- 組み込みメモリエンジン: デフォルトの SQLite バックエンド。
- QMD メモリエンジン: 高度なローカル優先サイドカー。
- Honcho メモリ: AI ネイティブなクロスセッションメモリ。
- Memory LanceDB: OpenAI 互換の埋め込みを備えた LanceDB バックエンドPlugin。
- Memory Wiki: コンパイル済みナレッジ Vault と Wiki ネイティブツール。
- メモリ検索: 検索パイプライン、プロバイダー、調整。
- Dreaming: 短期想起から長期メモリへのバックグラウンド昇格。
- メモリ設定リファレンス: すべての設定項目。
- Compaction: Compaction がメモリとどのように相互作用するか。