QMD メモリエンジン

​

組み込みより追加される機能

• リランキングとクエリ拡張により、再現率を高めます。
• 追加ディレクトリのインデックス化 - プロジェクトドキュメント、チームメモ、ディスク上のあらゆるもの。
• セッショントランスクリプトのインデックス化 - 以前の会話を思い出せます。
• 完全にローカル - 公式の llama.cpp プロバイダー Plugin と連携して動作し、GGUF モデルを自動ダウンロードします。
• 自動フォールバック - QMD が利用できない場合、OpenClaw はシームレスに組み込みエンジンへフォールバックします。

​

はじめに

​

前提条件

• QMD をインストールします: npm install -g @tobilu/qmd または bun install -g @tobilu/qmd
• 拡張を許可する SQLite ビルド（macOS では brew install sqlite）。
• QMD はゲートウェイの PATH 上にある必要があります。
• macOS と Linux はそのまま動作します。Windows は WSL2 経由が最もよくサポートされています。

​

有効化

{
  memory: {
    backend: "qmd",
  },
}

​

サイドカーの仕組み

• OpenClaw はワークスペースのメモリファイルと設定済みの memory.qmd.paths からコレクションを作成し、QMD マネージャーが開いたときとその後定期的に qmd update を実行します（memory.qmd.update.interval、デフォルトは 5m）。更新はインプロセスのファイルシステムクロールではなく、QMD サブプロセス経由で実行されます。セマンティック検索モードでは qmd embed も実行されます（memory.qmd.update.embedInterval、デフォルトは 60m）。
• デフォルトのワークスペースコレクションは、MEMORY.md と memory/ ツリーを追跡します。小文字の memory.md はルートメモリファイルとしてインデックス化されません。
• QMD 自身のスキャナーは、隠しパスと、.git、.cache、node_modules、vendor、dist、build などの一般的な依存関係/ビルドディレクトリを無視します。Gateway 起動時はデフォルトで QMD を初期化しません（memory.qmd.update.startup のデフォルトは off）。そのため、コールドブート時はメモリが最初に使われるまで、メモリランタイムのインポートや長寿命ウォッチャーの作成を避けます。
• それでもゲートウェイ開始時に QMD を初期化するには、memory.qmd.update.startup を idle または immediate に設定します。memory.qmd.update.onBoot のデフォルトは true で、起動時に初回更新を実行します。その即時更新をスキップするには false に設定します（更新または埋め込み間隔が設定されている場合、長寿命マネージャーは引き続き開くため、QMD は通常のウォッチャー/タイマーを引き続き所有します）。
• 検索は設定済みの searchMode を使用します（デフォルト: search。vsearch と query もサポート）。search は BM25 のみのため、OpenClaw はそのモードではセマンティックベクトルの準備状況プローブと埋め込みメンテナンスをスキップします。モードが失敗した場合、OpenClaw は qmd query で再試行します。
• searchMode が query の場合、QMD のハイブリッドクエリパスをリランカーなしで使うには memory.qmd.rerank を false に設定します（QMD 2.1 以降が必要）。OpenClaw は直接 QMD CLI パスに --no-rerank を渡し、QMD の MCP クエリツールに rerank: false を渡します。
• 複数コレクションフィルターを通知する QMD リリースでは、OpenClaw は同一ソースのコレクションを 1 つの QMD 検索呼び出しにまとめます。古い QMD リリースでは、互換性のあるコレクション単位のフォールバックを維持します。
• QMD が完全に失敗した場合、OpenClaw は組み込み SQLite エンジンへフォールバックします。チャットターン内での繰り返し試行は、オープン失敗後に短時間バックオフするため、バイナリの欠落や壊れたサイドカー依存関係による再試行の集中を避けます。openclaw memory status とワンショット CLI プローブは引き続き QMD を直接再チェックします。

​

検索パフォーマンスと互換性

qmd search "router notes" --json -n 10 -c memory-root-main -c memory-dir-main

qmd --help | grep -i collection

​

モデルの上書き

export QMD_EMBED_MODEL="hf:Qwen/Qwen3-Embedding-0.6B-GGUF/Qwen3-Embedding-0.6B-Q8_0.gguf"
export QMD_RERANK_MODEL="/absolute/path/to/reranker.gguf"
export QMD_GENERATE_MODEL="/absolute/path/to/generator.gguf"

​

追加パスのインデックス化

{
  memory: {
    backend: "qmd",
    qmd: {
      paths: [{ name: "docs", path: "~/notes", pattern: "**/*.md" }],
    },
  },
}

​

セッショントランスクリプトのインデックス化

{
  agents: {
    defaults: {
      memorySearch: {
        experimental: { sessionMemory: true },
        sources: ["memory", "sessions"],
      },
    },
  },
  memory: {
    backend: "qmd",
    qmd: {
      sessions: { enabled: true },
    },
  },
}

​

検索スコープ

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

​

引用

​

使うべき場合

• より高品質な結果のためのリランキング。
• ワークスペース外のプロジェクトドキュメントやメモの検索。
• 過去のセッション会話の想起。
• API キー不要の完全ローカル検索。

​

トラブルシューティング

{
  memory: {
    backend: "qmd",
    qmd: {
      command: "/absolute/path/to/qmd",
    },
  },
}

​

設定

​

関連

• メモリ概要
• 組み込みメモリエンジン
• Honcho メモリ