Getting started guide

Give your AI agent a real memory
in 10 minutes

A beginner-friendly, step-by-step guide to installing Mnemebrain Lite and using it with AI Skills in OpenClaw — no coding experience required.

March 2026 ~10 min read No code needed
openclawsetup guidemnemebrain-lite
TL;DR
1pip install mnemebrain-lite then mnemebrain-lite serve
2git clone mnemebrain-skills and pip install -r requirements.txt in the integration folder
3Edit config.yaml — set your agent name. Register the skill in OpenClaw → Settings → Skills → Add Skill
4Start a conversation. Tell your agent something. Close it. Open a new one. It still knows.
What you'll do in this guide

Most AI assistants forget everything the moment a conversation ends. They can't remember what you told them last week, can't notice when two things they know contradict each other, and can't explain why they believe something.

Mnemebrain changes that. It gives your AI agent a structured belief memory — not just a list of facts, but a system that tracks evidence, detects conflicts, and learns over time. And AI Skills for OpenClaw let you drop that memory into any AI workflow without writing a single line of code.

This guide walks you through the whole thing, step by step, like you've never touched a terminal before (even if you have).

What you'll need: A computer running macOS, Windows, or Linux. An internet connection. Python installed (we'll check). That's it.
01

What is Mnemebrain, exactly?

The 2-minute version

Think of a normal AI assistant's memory like a sticky note. You write something on it, and later it can read it back. But it doesn't know if that note is still true, doesn't notice if two sticky notes say opposite things, and has no idea where the information came from.

Mnemebrain replaces the sticky note with something closer to how your brain actually works: every piece of knowledge has evidence (where did this come from?), a confidence level (how sure are we?), and a history (has this ever changed?).

When your agent learns something new that contradicts an old belief, Mnemebrain notices, flags the conflict, and updates accordingly — the same way a thoughtful person would.

What this unlocks for your agent
  • Remember user preferences, facts, and decisions across sessions
  • Automatically detect when new information contradicts something it already believes
  • Explain why it believes something, with full evidence trail
  • Revise old beliefs when better information arrives
  • Work with AI Skills in OpenClaw without any custom code

Mnemebrain Lite is the open-source, local version. It runs entirely on your machine, stores everything in a local database, and is free to use. The full version (accessible at localhost:8000 when running) adds more advanced features — but Lite is the perfect place to start.

You OpenClaw AI Skill integration Mnemebrain REST API Memory :8000 Kuzu DB chat HTTP YOUR MACHINE — FULLY LOCAL
02

Install Mnemebrain Lite

One command — takes about 30 seconds

First, open your Terminal (on Mac: press ⌘ + Space, type "Terminal", press Enter) or Command Prompt (on Windows: press the Windows key, type "cmd", press Enter).

Check that Python is installed by typing this and pressing Enter:

Terminal
python --version

You should see something like Python 3.10.4. Any version 3.10 or higher works. If you see an error, download Python here first.

Now install Mnemebrain Lite:

Terminal
pip install mnemebrain-lite

That's it. pip (Python's package installer) downloads and installs everything automatically. You'll see a progress bar, then a success message.

Got an error? Try pip3 install mnemebrain-lite instead. On some systems Python 3 uses pip3 rather than pip.

Confirm it installed correctly:

Terminal
python -c "import mnemebrain_core; print('Mnemebrain ready ✓')"

If you see Mnemebrain ready ✓ — you're set.

03

Start the memory server

Keep this running in the background

Mnemebrain runs as a small local server on your computer. Your AI agent connects to it to store and retrieve beliefs. Start it with:

Terminal
mnemebrain-lite serve

You should see output like:

Server output
INFO     MnemeBrain Lite v0.x.x starting...
INFO     Storage: ./mnemebrain.db (Kuzu graph database)
INFO     Server running on http://localhost:8000
INFO     API docs:  http://localhost:8000/docs

Leave this terminal window open. The server needs to keep running. Open a new terminal window for the next steps.

Pro tip: You can open http://localhost:8000/docs in your browser to see a live, interactive view of everything the memory server can do. It's a great way to explore.
04

Install an AI Skill in OpenClaw

Download the Mnemebrain skill pack

OpenClaw uses "AI Skills" — pre-built modules you can drop into any agent to give it new abilities. The Mnemebrain skill pack teaches your agent how to read from and write to its belief memory.

Download the skills from GitHub. In your terminal (the new one you opened), run:

Terminal
# Download the Mnemebrain skills repository
git clone https://github.com/mnemebrain/mnemebrain-skills.git

# Move into the folder
cd mnemebrain-skills

If you don't have git, you can also download the ZIP file directly from GitHub and unzip it anywhere on your computer.

Inside, you'll find two main skill folders:

Skill folders included
  • mnemebrain-lite-integration — the main skill that connects OpenClaw agents to your Mnemebrain memory server
  • mnemebrain-lite-proof — a demo skill that proves the memory is working by running a quick test

Now install the integration skill's dependencies:

Terminal
cd mnemebrain-lite-integration
pip install -r requirements.txt
05

Connect the skill to Mnemebrain

One config file — takes 2 minutes

The skill needs to know where your Mnemebrain server is running. Open the file called config.yaml inside the mnemebrain-lite-integration folder. You can use any text editor — Notepad, TextEdit, VS Code, whatever you have.

It will look something like this:

config.yaml
mnemebrain:
  host: http://localhost:8000    # leave this as-is
  agent_id: my-agent             # give your agent a name
  auto_store: true               # store beliefs automatically

Change my-agent to whatever name you want for your agent (no spaces — use hyphens like project-helper or sales-bot). Save the file.

Now register the skill with OpenClaw. In OpenClaw's interface, go to Settings → Skills → Add Skill and point it to the mnemebrain-lite-integration folder you just configured.

🖥
OpenClaw → Settings → Skills → Add Skill
Already using OpenClaw's workspace feature? You can also use the mnemebrain-lite-integration-workspace folder instead — it's the same skill, packaged as a full workspace template.
06

Talk to your agent — watch it remember

The moment everything clicks

Start a conversation with your agent in OpenClaw. Tell it something you want it to remember:

You → Agent
My budget for this project is $5,000 and the deadline is April 15th.

Behind the scenes, Mnemebrain just stored two beliefs:

Stored in memory
{
  "claim":      "project budget is $5,000",
  "confidence": 0.95,
  "evidence":   ["user_message_001"],
  "source":     "user_direct_statement"
}

{
  "claim":      "project deadline is April 15th",
  "confidence": 0.95,
  "evidence":   ["user_message_001"],
  "source":     "user_direct_statement"
}

Now close the conversation. Start a completely new one. Ask:

New conversation
What's our project deadline?

Your agent will answer: "Your project deadline is April 15th." — without you having to repeat yourself.

Cross-session memory — two completely separate conversations
Conversation 1
You: My budget for this project
is $5,000 and the deadline
is April 15th.

↳ believe() ×2 stored
confidence: 0.95 each
evidence: [msg_001]

You: [closes conversation]
Conversation 2 — fresh session, new context
You: What's our project deadline?

↳ search() called
query: "project deadline"

Agent: Your project deadline is
April 15th (confidence: 0.95).

Now try something more interesting. Tell it something that contradicts the first thing:

You → Agent
Actually, the budget was just increased to $8,000.
What Mnemebrain does automatically
  • Detects that this contradicts the existing "$5,000" belief
  • Records an "ATTACKS" edge between the old and new information
  • Revises the belief — confidence in the old claim drops, confidence in the new claim rises
  • Keeps both pieces of evidence in the history, so nothing is ever truly lost
ATTACKS edge — what happens inside Mnemebrain
Conv 1: "project budget is $5,000"
Conv 2: "budget increased to $8,000"

// conflict detected — not silently overwritten
truth_state: BOTH
belief_1: "$5,000" confidence: 0.95 → 0.28
belief_2: "$8,000" confidence: 0.92
evidence_trail: msg_001 → msg_008

// agent surfaces the conflict, not a silent answer
Agent: ⚠ Budget conflict detected.
Current best: $8,000. Previous: $5,000.
Both stored with full evidence trail.

This is what separates Mnemebrain from a simple memory store: it doesn't just overwrite. It reasons. No other memory tool for OpenClaw does this — a plain vector store would silently replace the old fact and you'd never know a conflict existed.

07

See what's inside your agent's memory

Inspect, verify, and explore

You can inspect everything your agent believes at any time. The easiest way is the interactive API explorer — open your browser and go to:

Browser
http://localhost:8000/docs

You'll see a list of all the available operations. Click GET /beliefs, then click Try it out → Execute to see everything currently in memory.

You can also run the proof skill to verify everything is connected and working:

Terminal
# From the mnemebrain-skills folder
cd mnemebrain-lite-proof
python run_proof.py

This runs a quick end-to-end test: it stores a belief, retrieves it, creates a contradiction, verifies the conflict is detected, then cleans up. If everything passes, you'll see:

Output
[1/4] Storing belief...          ✓
[2/4] Retrieving belief...        ✓
[3/4] Detecting contradiction...  ✓
[4/4] Verifying revision...       ✓

All checks passed. Mnemebrain is working correctly.
Want to see beliefs in plain English? Ask your agent: "What do you currently believe about this project?" — with the Mnemebrain skill active, it will pull its current beliefs and summarize them for you, including confidence levels.

That's it. Your AI agent now has a real, structured memory that persists between conversations, detects contradictions, and can explain what it knows and why.

You just gave your AI a real brain.

From here, explore the full Mnemebrain SDK for deeper integrations, or check out the architecture spec to understand the belief system powering it all.

Browse all AI Skills →