組み込みメモリエンジン

​

提供される機能

• FTS5 全文インデックス（BM25 スコアリング）によるキーワード検索。
• サポートされている任意のプロバイダーの埋め込みによるベクトル検索。
• 最良の結果を得るために両方を組み合わせるハイブリッド検索。
• 中国語、日本語、韓国語向けのトライグラムトークン化によるCJK サポート。
• データベース内ベクトルクエリ向けの sqlite-vec アクセラレーション（オプション）。

​

はじめに

{
  memory: {
    search: {
      provider: "openai",
    },
  },
}

openclaw plugins install @openclaw/llama-cpp-provider

{
  memory: {
    search: {
      provider: "local",
      fallback: "none",
      local: {
        modelPath: "~/.node-llama-cpp/models/embeddinggemma-300m-qat-Q8_0.gguf",
      },
    },
  },
}

​

サポートされている埋め込みプロバイダー

​

インデックス作成の仕組み

• インデックスの場所: 所有エージェントのデータベース ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite
• ストレージのメンテナンス: SQLite WAL サイドカーは、定期チェックポイントと シャットダウン時のチェックポイントによって上限が保たれます。
• ファイル監視: メモリファイルへの変更により、デバウンスされた再インデックスが トリガーされます（デフォルトは 1.5 秒）。
• 自動再インデックス: 埋め込みプロバイダー、モデル、チャンク設定、 設定済みソース、またはスコープが変更されると、インデックスは自動的に再構築されます。
• オンデマンド再インデックス: openclaw memory index --force

​

使用する場合

• 追加の依存関係なしで、そのまま利用できます。
• キーワード検索とベクトル検索の両方を適切に処理します。
• すべての埋め込みプロバイダーをサポートします。
• ハイブリッド検索により、両方の検索手法の長所を組み合わせます。

​

トラブルシューティング

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

​

設定

​

関連項目

• メモリの概要
• メモリ検索
• Active Memory