matrixorigin/memoria

Secure memory management for AI Agents • Ensures data integrity • Reduces hallucinations • Maintains consistent long-term context

什麼是 Memoria？

Memoria 是一個為 AI 代理提供 持久化記憶層 的系統，將 Git 風格的版本控制引入代理的內部知識。代理的「記憶」（事實、偏好、操作步驟等）的每一次變更都會以快照形式儲存，支援分支、合併和時間點回滾，並可透過混合向量＋全文檢索引擎進行搜尋。該系統基於 MatrixOne 的寫時複製資料庫建構，實現零複製分支與不可變儲存。

核心功能

功能	Memoria 的實現方式
Git 級別版本控制	對任何記憶變更提供即時快照、分支、合併和時間點回滾。
語意檢索	混合向量＋全文檢索使代理能根據語意而非僅關鍵字查找記憶。
自我治理	自動檢測矛盾或低置信度記憶，隔離並產生審計日誌。
隱私保護	可選擇運行本地嵌入模型，確保資料不離開本地機器。
跨會話持久性	記憶（事實、偏好、目標）在不同會話間保持持久。
完整審計日誌	每次變更均記錄來源資訊，可後續審查。

誰可以使用？

Memoria 可與任何 MCP 兼容 的 AI 代理協同工作。README 列出了以下已準備好的整合：

Kiro
Cursor
Claude Code
OpenAI Codex
Gemini CLI
OpenClaw（透過插件）

您也可以直接從自訂代理呼叫其 REST API。

快速入門

雲端服務（推薦） – 訪問 thememoria.ai 註冊帳號，安裝 CLI，以 Remote 模式執行 memoria init -i 並提供金鑰。
自托管 – 使用提供的 Docker Compose 啟動 MatrixOne 實例和 Memoria API，然後以 Embedded 模式執行 CLI。
OpenClaw 插件 – 安裝插件，並設定雲端或自托管端點。

二進位檔也可在 GitHub 發布頁面取得。

代理如何使用它

Memoria 暴露一組 MCP 工具，代理可呼叫，例如：

memory_store – 新增新事實或上下文。
memory_retrieve / memory_search – 在會話開始或按需取得相關記憶。
memory_branch, memory_checkout, memory_merge – 在獨立分支上實驗，之後合併優質結果。
memory_snapshot, memory_rollback – 建立命名檢查點並按需回滾。
治理工具（memory_governance, memory_consolidate）自動清理矛盾。

引導規則（如 memory, session‑lifecycle, memory‑hygiene）告訴代理何時呼叫這些工具。

架構概覽

遠端模式 – 代理透過 Memoria CLI（MCP 橋接）與 Memoria 雲端服務通訊，請求透過 HTTP 轉發。
嵌入模式 – CLI 執行本地 MCP 伺服器，直接與 MatrixOne 資料庫通訊，處理向量儲存、全文索引和資料版控層。

誰可能需要它？

需要在多次互動中保持可靠、可審計狀態的 自主代理開發者。
需要對檢索上下文進行版本控制和可逆操作的 RAG 流水線。
探索自我治理記憶系統或資料驅動 AI 的 研究人員。
要求嚴格審計日誌並能回滾代理知識庫錯誤更新的企業。

許可與社群

Memoria 以 Apache‑2.0 許可證發行。專案為開源，提供 CI 流水線，歡迎透過標準 GitHub 工作流程貢獻程式碼。

TL;DR – Memoria 是 AI 代理的 Git 風格、版本控制的記憶儲存，支援快照、分支、語意搜尋和自動一致性檢查，可透過雲端或自托管部署使用。