メモリ設定リファレンス

このページでは、OpenClaw のメモリ検索に関するすべての設定項目を一覧で説明します。概念の概要については、以下を参照してください。

共有メモリのすべての設定は、openclaw.json の最上位 memory にあります。検索のデフォルト設定には memory.search を使用し、エージェントごとの検索オーバーライドには agents.entries.*.memory.search を使用します。

会話をまたいで記憶する

信頼できるパーソナルエージェントだけが会話をまたいだトランスクリプトの想起を使用する場合は、 エージェントごとに設定します。

{  agents: {    entries: {      personal: {        memory: {          search: {            rememberAcrossConversations: true,          },        },      },    },  },}

この値は通常の memory.search 継承に従い、 エージェントごとにオーバーライドできます。未設定の場合、グローバルな session.dmScope が未設定または "main" であり、どのバインディングにも session.dmScope オーバーライドがない場合にのみ、デフォルトでオンになります。DM 分離が設定されている場合、デフォルトはオフになります。明示的な true または false が常に優先されます。有効にするとセッショントランスクリプトのインデックス作成も有効になり、 エージェントの解決済みメモリソースに sessions が追加されます。QMD では、 そのエージェントのセッションエクスポートも有効になります。このモードでは別途 memory.qmd.sessions.enabled を設定する必要はありません。

OpenClaw の組み込みメモリプロバイダーは、組み込みバックエンドと QMD バックエンドの両方で、 この保護されたパスをサポートします。代替メモリプロバイダーは独自の 想起フックと高度な Active Memory ツールを引き続き使用できますが、現在のプロバイダーが 保護された非公開トランスクリプトの想起をサポートしていない限り、この設定はスキップされます。 openclaw doctor は、サポートされていないプロバイダー、または memory_search を省略した明示的な Active Memory の toolsAllow リストを報告します。

取得の境界は一般的なセッション検索よりも狭くなります。

• 対象となるのは、同じエージェントが認識している非公開会話のみです
• 回答対象の会話は除外されます
• グループとチャンネルは、取得元と取得先の両方から除外されます
• 会話の種類が不明な場合はフェイルクローズします
• サンドボックス化された想起では、会話をまたぐ特別な認可を使用できません

この設定は、tools.sessions.visibility、セッションキー、 トランスクリプトの保存、配信ルーティング、または sessions_list、 sessions_history、sessions_send の権限を変更しません。Active Memory は範囲を限定した 読み取り専用の取得処理を実行します。取得が利用できない場合やタイムアウトした場合でも、 応答はブロックされません。

プロバイダーの選択

provider が設定されていない場合、OpenClaw は OpenAI の埋め込みを使用します。Bedrock、DeepInfra、Gemini、GitHub Copilot、Mistral、Ollama、 Voyage、ローカル GGUF モデル、または OpenAI 互換の /v1/embeddings エンドポイントを使用するには、provider を明示的に設定します。 引き続き provider: "auto" を使用しているレガシー設定は、openai として解決されます。

provider が未設定の場合、レガシーな provider: "auto" が存在する場合、または provider: "none" で意図的に FTS のみのモードを選択している場合、埋め込みが利用できなくても、 メモリ想起では字句 FTS ランキングを引き続き使用できます。

明示的に指定された非ローカルプロバイダーはフェイルクローズします。memory.search.provider を Bedrock、DeepInfra、Gemini、GitHub Copilot、LM Studio、Mistral、Ollama、OpenAI、Voyage、OpenAI 互換の カスタムプロバイダーなど、リモートバックエンドを使用する特定のプロバイダーに設定し、そのプロバイダーが実行時に利用できない場合、 memory_search は暗黙的に FTS のみの想起を使用せず、利用不可の結果を返します。 プロバイダーまたは認証の設定を修正するか、到達可能なプロバイダーに切り替えるか、 意図的に FTS のみの想起を使用する場合は provider: "none" を設定してください。

カスタムプロバイダー ID

memory.search.provider は、ollama などのメモリ専用プロバイダーアダプター、または openai-responses / openai-completions などの OpenAI 互換モデル API 用のカスタム models.providers.<id> エントリを指すことができます。OpenClaw は、エンドポイント、認証、モデルプレフィックスの処理用にカスタムプロバイダー ID を維持しながら、埋め込みアダプター用にそのプロバイダーの api 所有者を解決します。これにより、複数 GPU または複数ホストの構成で、メモリ埋め込み専用の特定のローカルエンドポイントを使用できます。

{  models: {    providers: {      "ollama-5080": {        api: "ollama",        baseUrl: "http://gpu-box.local:11435",        apiKey: "ollama-local",        models: [{ id: "qwen3-embedding:0.6b", name: "Qwen3 Embedding 0.6B" }],      },    },  },  memory: {    search: {      provider: "ollama-5080",      model: "qwen3-embedding:0.6b",    },  },}

API キーの解決

リモート埋め込みには API キーが必要です。ただし、Bedrock は代わりに AWS SDK のデフォルト認証情報チェーン（インスタンスロール、SSO、アクセスキー、または Bedrock API キー）を使用します。

リモートエンドポイントの設定

グローバルな OpenAI チャット認証情報を継承しない汎用 OpenAI 互換 /v1/embeddings サーバーには、provider: "openai-compatible" を使用します。

{  memory: {    search: {      provider: "openai-compatible",      model: "text-embedding-3-small",      remote: {        baseUrl: "https://api.example.com/v1/",        apiKey: "YOUR_KEY",      },    },  },}

プロバイダー固有の設定

{  memory: {    search: {      provider: "openai-compatible",      remote: {        baseUrl: "https://embeddings.example/v1",        apiKey: "${EMBEDDINGS_API_KEY}",      },      model: "asymmetric-embedder",      queryInputType: "query",      documentInputType: "passage",    },  },}

{  memory: {    search: {      provider: "bedrock",      model: "amazon.titan-embed-text-v2:0",    },  },}

{  "Effect": "Allow",  "Action": "bedrock:InvokeModel",  "Resource": "*"}

arn:aws:bedrock:*::foundation-model/amazon.titan-embed-text-v2:0

openclaw memory status --deep --agent mainopenclaw memory index --force --agent main

インデックス作成の動作

メモリエンジンは、同期、バッチ処理、監視、および Compaction 後の インデックス作成ヒューリスティクスを管理します。OpenClaw はインストールごとの タイミング切り替えを公開するのではなく、管理されたデフォルトでこれらの動作を有効に保ちます。

ハイブリッド検索の設定

すべて memory.search.query 配下です。

ハイブリッド検索は引き続き有効です。MMR と時間減衰は、 組み込みエンジンのポリシーによって無効のままです。

完全な例

{  memory: {    search: {      query: {        maxResults: 6,        minScore: 0.35,      },    },  },}

追加のメモリパス

{  memory: {    search: {      extraPaths: ["../team-docs", "/srv/shared-notes"],    },  },}

パスには絶対パスまたはワークスペース相対パスを指定できます。ディレクトリでは .md ファイルが再帰的にスキャンされます。シンボリックリンクの処理はアクティブなバックエンドによって異なります。組み込みエンジンはシンボリックリンクをスキップしますが、QMD は基盤となる QMD スキャナーの動作に従います。

エージェントスコープのエージェント間トランスクリプト検索には、memory.qmd.paths ではなく agents.entries.*.memory.search.qmd.extraCollections を使用してください。これらの追加コレクションは同じ { path, name, pattern? } 形式に従いますが、エージェントごとにマージされ、パスが現在のワークスペース外を指す場合は明示的な共有名を維持できます。同じ解決済みパスが memory.qmd.paths と memory.search.qmd.extraCollections の両方に現れる場合、QMD は最初のエントリを保持し、重複をスキップします。

マルチモーダルメモリ（Gemini）

Gemini Embedding 2 を使用して、Markdown とともに画像と音声のインデックスを作成します。

対応形式：.jpg、.jpeg、.png、.webp、.gif、.heic、.heif（画像）、.mp3、.wav、.ogg、.opus、.m4a、.aac、.flac（音声）。

埋め込みキャッシュ

再インデックスまたはトランスクリプトの更新時に、変更されていないテキストが再度埋め込み処理されるのを防ぎます。

バッチインデックス作成

gemini、openai、および voyage で利用できます。大規模なバックフィルでは、通常 OpenAI のバッチが最も高速かつ低コストです。

並行処理、ポーリング、およびタイムアウトの動作はプロバイダーが管理します。

セッションメモリ検索

セッショントランスクリプトのインデックスを作成し、memory_search を介して提示します。

通常のモデルから呼び出されるセッショントランスクリプト検索は、 tools.sessions.visibility に従います。デフォルトの tree 可視性では、現在のセッション、そのセッションが生成したセッション、および 周辺のグループ認識を通じて監視される同一エージェントのグループセッションが公開されます。その他の 無関係なセッションには agent 可視性が必要です（エージェントをまたぐ 想起も必要で、かつエージェント間ポリシーで許可されている場合に限り all）。

rememberAcrossConversations はこの設定を拡張しません。これは、範囲が限定された Active Memory パス中の 同一エージェントのプライベートトランスクリプトに限定された、 実行時専用の個別の認可を提供します。

以下の例では、これらの設定をトップレベルの memory.search 配下に配置しています。1 つの エージェントのみがセッショントランスクリプトをインデックス化して検索する必要がある場合は、 エージェントごとの memory.search オーバーライドで同等の設定を適用することもできます。

同一エージェントの Gateway から DM への想起の場合：

{  memory: {    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },  },  tools: {    sessions: { visibility: "agent" },  },}

{  memory: {    backend: "qmd",    search: {      experimental: { sessionMemory: true },      sources: ["memory", "sessions"],    },    qmd: {      sessions: { enabled: true },    },  },  tools: {    sessions: { visibility: "agent" },  },}

QMD を使用する場合、sources: ["sessions"] だけではトランスクリプトは QMD にエクスポートされません。 memory.qmd.sessions.enabled: true も設定してください。より上位の rememberAcrossConversations: true 設定は例外で、そのエージェントに必要な QMD セッションエクスポートを暗黙的に有効にします。暗黙的なエクスポートは非公開のままです。 常にデフォルトの内部エクスポート先を使用し（設定された sessions.exportDir は明示的なエクスポートにのみ適用されます）、そのエージェントによる会話横断の 想起中にのみ検索され、通常の memory_get からは読み取れません。明示的な memory.qmd.sessions.enabled: true は従来の動作を維持し、 エクスポートされたトランスクリプトを通常のメモリコーパスに含めます。

SQLite ベクトル高速化（sqlite-vec）

sqlite-vec が利用できない場合、OpenClaw は自動的にプロセス内のコサイン類似度へフォールバックします。

インデックスストレージ

組み込みメモリインデックスは、各エージェントの OpenClaw SQLite データベース内の agents/<agentId>/agent/openclaw-agent.sqlite に保存されます。

QMD バックエンド設定

有効にするには memory.backend = "qmd" を設定します。すべての QMD 設定は memory.qmd 配下にあります。

searchMode: "search" は字句/BM25 専用です。OpenClaw はこのモードでは、memory status --deep 中を含め、 セマンティックベクトルの準備状態プローブや QMD 埋め込みのメンテナンスを実行しません。 vsearch と query では、引き続き QMD ベクトルの準備完了と埋め込みが必要です。

rerank: false は QMD の query モードのみを変更し、QMD 2.1 以降が必要です。直接 CLI モードでは OpenClaw は --no-rerank を渡し、mcporter 経由の MCP モードでは QMD の統合クエリツールに rerank: false を渡します。QMD のデフォルトのクエリ再ランキング動作を使用するには、未設定のままにしてください。

OpenClaw は現在の QMD コレクションおよび MCP クエリ形式を優先しますが、必要に応じて互換性のある コレクションパターンフラグや旧 MCP ツール名を試すことで、古い QMD リリースも動作するよう維持します。 QMD が複数のコレクションフィルターへの対応を通知する場合、同一ソースのコレクションは 1 つの QMD プロセスで検索されます。古い QMD ビルドでは、コレクションごとの互換パスが維持されます。同一ソースとは、 永続メモリコレクション（デフォルトのメモリファイルとカスタムパス）をまとめてグループ化することを意味します。 一方、セッショントランスクリプトのコレクションは別のグループのままとなり、ソースの多様化に引き続き両方の入力が含まれます。

{  memory: {    qmd: {      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },    },  },}

QMD はメモリが初めて使用されたときに遅延初期化され、そのアダプターが更新と埋め込みのスケジュールを管理します。

QMD の完全な例

{  memory: {    backend: "qmd",    citations: "auto",    qmd: {      includeDefaultMemory: true,      update: { interval: "5m", debounceMs: 15000 },      limits: { maxResults: 4, timeoutMs: 4000 },      scope: {        default: "deny",        rules: [{ action: "allow", match: { chatType: "direct" } }],      },      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],    },  },}

Dreaming

Dreaming は memory.search 配下ではなく、plugins.entries.memory-core.config.dreaming 配下で設定します。

Dreaming は 1 回のスケジュールされたスイープとして実行され、内部の light/deep/REM フェーズを実装の詳細として使用します。

概念的な動作とスラッシュコマンドについては、Dreaming を参照してください。

ユーザー設定

例

{  plugins: {    entries: {      "memory-core": {        subagent: {          allowModelOverride: true,          allowedModels: ["anthropic/claude-sonnet-4-6"],        },        config: {          dreaming: {            enabled: true,            frequency: "0 3 * * *",            model: "anthropic/claude-sonnet-4-6",          },        },      },    },  },}

関連項目

• 設定リファレンス
• メモリの概要
• メモリ検索