マルチエージェントメモリ完全解説：AIエージェント向け共有メモリシステム

Multi-Agent Memoryは、マシン、ツール、フレームワークをまたいで動作する共有メモリシステムをAIエージェントに提供するオープンソースプロジェクトです。このプロジェクトは、OpenClawエージェント、Claude Code、n8nワークフローが別々のマシン間でメモリを共有する必要があった本番環境のセットアップから生まれました。

解決する課題

開発用のClaude Code、自律タスク用のOpenClaw、自動化用のn8nといった複数のAIエージェントを実行する場合、各エージェントは独自のコンテキストを維持し、セッション間ですべてを忘れてしまいます。既存のソリューションは、単一マシン専用であるか、有料のクラウドサービスが必要であるか、あるいは事実とイベントが根本的に異なることを理解せずにメモリを単純なキーバリューストアとして扱っています。

変異セマンティクスを持つ型付きメモリ

このシステムは4つの異なるメモリタイプを理解し、それぞれ独自のライフサイクルを持っています：

イベント: 追加のみ可能で不変の履歴記録。使用例：「デプロイメント完了」、「ワークフロー失敗」
事実: キーによるアップサート、新しい事実が古いものを置き換えます。使用例：「APIステータス：正常」、「クライアントはダークモードを好む」
ステータス: サブジェクトによるその場での更新、最新のものが優先されます。使用例：「ビルドパイプライン：合格」、「移行：進行中」
決定: 追加のみ可能、選択と理由を記録します。使用例：「MySQLではなくPostgresを選択した理由は...」

メモリライフサイクル

システムは次のプロセスに従います：保存 → 重複チェック → 置き換えチェーン → 信頼度減衰 → LLM統合

重複排除: コンテンツは保存時にハッシュ化され、完全な重複は既存のメモリを返します
置き換え: 既存の事実と同じキーを持つ事実を保存する場合、古いものは非アクティブとしてマークされ、新しいものはそれにリンクバックします
信頼度減衰: 事実とステータスは、アクセスされないと時間の経過とともに信頼度が低下します（設定可能、デフォルトは1日あたり2%）。イベントと決定は減衰しません
LLM統合: 定期的なバックグラウンドプロセス（設定可能、デフォルトは6時間ごと）が未統合のメモリをLLMに送信し、統合する重複の検出、フラグを立てる矛盾、メモリ間の関連性、クロスメモリの洞察を見つけます

セキュリティ機能

認証情報スクラビング: すべてのコンテンツは保存前にスクラブされます。APIキー、JWT、SSH秘密鍵、パスワード、base64エンコードされたシークレットは自動的に編集されます
エージェント分離: APIはエージェントとデータの間のゲートキーパーとして機能します。エージェントはメモリの保存と検索、ブリーフィングと統計の読み取りのみ可能です。メモリの削除、テーブルの削除、認証情報スクラビングの回避、ファイルシステム/データベースへの直接アクセス、他のエージェントのメモリの遡及的変更はできません
セキュリティ実装: cr****.timingSafeEqual()を使用したタイミングセーフな認証、環境変数を必要とする起動時の検証、保存前の認証情報スクラビング