OpenClaw-Mem0プラグインは、コンテキストウィンドウ外に永続メモリを追加します

openclaw-mem0プラグインは、メモリをコンテキストウィンドウの外部に保存することで、OpenClawのデフォルトのメモリ制限に対処し、コンテキスト圧縮、トークン制限、セッション再起動の影響を受けないようにします。

OpenClawにおけるメモリの問題

OpenClawエージェントはセッション間でステートレスであり、デフォルトのメモリは明示的に読み込む必要があるファイルに保存されます。コンテキスト圧縮は古いコンテキストを要約してトークンを節約するため、注入されたメモリは損失が発生します。大きなメモリファイルや学習した事実は警告なしに圧縮、書き換え、または削除されます。

包括的なMEMORY.mdファイル、ローカルのBM25 + ベクトル検索エンジン、SQLiteベースのセッションログなどのコミュニティの回避策は、すべて同じ制限を共有しています。それらはメモリをコンテキストウィンドウ内に保存するため、圧縮やセッション再起動の影響を受けやすくなります。

プラグインの仕組み

このプラグインは、会話のターンごとに2つのプロセスを実行します。

• 自動想起: エージェントが応答する前にMem0で関連するメモリを検索し、一致するコンテキスト（好み、過去の決定、プロジェクトの詳細）を毎ターンの作業コンテキストに注入します。
• 自動キャプチャ: エージェントが応答した後、各やり取りをMem0に送信し、Mem0の抽出層が永続化する価値があるものを判断します。新しい事実は保存され、古くなったものは更新され、重複は統合されます。

両方のプロセスは、インストール時にデフォルトで有効になります。

メモリ構造

このプラグインはメモリを2つのスコープに分けます。

• 長期記憶: ユーザースコープで、すべてのセッションにわたって永続化されます（名前、技術スタック、プロジェクト構造、決定など）。
• 短期記憶: セッションスコープで、長期記憶ストアを汚染することなく、アクティブな作業を追跡します。

両方のスコープは毎回の想起時に検索され、長期記憶が最初に表示されます。

エージェントには、明示的なメモリ管理のための5つのツールが提供されます。

• memory_search - すべてのメモリにわたる意味的クエリ
• memory_store - 特定の事実を明示的に保存
• memory_list - 保存されたすべてのメモリを表示
• memory_get - IDで特定のメモリを取得
• memory_forget - メモリを削除（GDPR準拠）

セットアップオプション

クラウドセットアップ（最も簡単）:

openclaw plugins install @mem0/openclaw-mem0

app.mem0.aiからAPIキーを取得し、openclaw.jsonに追加します。

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "apiKey": "${MEM0_API_KEY}",
      "userId": "your-user-id"
    }
  }
}

完全ローカル、完全プライベート（セルフホスト）:

"mode": "open-source"を設定し、独自のスタックを持ち込みます。

{
  "openclaw-mem0": {
    "enabled": true,
    "config": {
      "mode": "open-source",
      "userId": "your-user-id",
      "oss": {
        "embedder": {
          "provider": "ollama",
          "config": {
            "model": "nomic-embed-text"
          }
        },
        "vectorStore": {
          "provider": "qdrant",
          "config": {
            "host": "localhost",
            "port": 6333
          }
        }
      }
    }
  }
}