Memorine

Persistent memory for OpenClaw agents. No APIs, no Docker, no external services. Just Python and SQLite.

What it does

• - Facts -- store, recall, and search with full-text search (FTS5). Near-duplicates are reinforced, contradictions are flagged automatically.
• Forgetting curve -- memories decay over time if not accessed, just like human memory. Old garbage cleans itself up.
• Events -- log what happened with causal chains (this caused that, which caused this other thing).
• Procedures -- track multi-step workflows, learn which steps tend to fail, anticipate what you will need before starting a task.
• Cross-agent sharing -- agents share facts with each other or the whole team through the same database.
• Semantic search (optional) -- install memorine[embeddings] to add meaning-based search on top of keyword search.

14 MCP tools

Once installed, your agents get access to:

Tool	What it does
INLINECODE1	Store a fact. Detects contradictions.
INLINECODE2

Batch-learn multiple facts at once. |
| memorine_recall | Search memory by query. Ranked by importance and recency. |
| memorine_log_event | Record an event. Supports causal chains. |
| memorine_events | Search past events by text or tags. |
| memorine_share | Share a fact with another agent or the team. |
| memorine_team_knowledge | Get collective knowledge across agents. |
| memorine_profile | Full cognitive profile of what an agent knows. |
| memorine_anticipate | Predict what you need for a task before starting. |
| memorine_procedure_start | Start tracking a procedure. |
| memorine_procedure_step | Log a step result in a running procedure. |
| memorine_procedure_complete | Mark a procedure as done. |
| memorine_correct | Fix a fact that turned out to be wrong. |
| memorine_stats | Database stats: facts, events, procedures, db size. |

Setup

Install Memorine:

CODEBLOCK0

Add the MCP server to your OpenClaw config (openclaw.json):

CODEBLOCK1

Allow the tools for your agents:

CODEBLOCK2

Optional semantic search (adds meaning-based matching on top of keyword search):

CODEBLOCK3

Security

Each agent can only modify its own data. Forget, correct, link, and procedure operations all validate ownership. No agent can touch another agent's memories.

How it works

Everything lives in a single SQLite file at ~/.memorine/memorine.db. FTS5 handles keyword search, triggers keep indexes in sync, and WAL mode allows concurrent reads. The forgetting curve uses retention = e^(-days / stability) where stability grows each time a memory is accessed. No LLM needed for any of this.