Adam Framework

AI Amnesia — Solved. Within-Session Coherence Degradation — Solved.

The Adam Framework is a 5-layer persistent memory architecture for OpenClaw agents, developed over 8 months across 353 sessions on a live business by a non-coder running consumer hardware.

OpenClaw just got acquired by OpenAI. Your memory layer shouldn't be.

What It Solves

AI Amnesia — your agent wakes up blank every session, forcing you to re-explain context, projects, and goals that should already be known
Within-Session Drift — as a session accumulates context, the model's reasoning consistency quietly degrades before compaction triggers

The 5 Layers

| Layer | Component | What It Does | |-------|-----------|--------------| | 1 | Vault injection via SENTINEL | Identity files loaded at every boot. Agent wakes up knowing who it is. | | 2 | memory-core plugin | Live memory search mid-session via memory_search / memory_get tools | | 3 | Neural graph (nmem_context) | Associative recall — 12,393 neurons, 40,532 synapses. Concepts link to concepts. | | 4 | Nightly reconciliation | Gemini merges daily logs into CORE_MEMORY.md while you sleep. Nothing lost. | | 5 | Coherence monitor | Scratchpad dropout detector — fires re-anchor before drift causes damage. 33 tests passing. |

The Key Insight

The memory is in the files. The model is just the reader.

When the system was completely wiped and rebuilt from scratch, the agent came back online with full continuity — because the identity files survived. Swap the LLM, keep the Vault. Memory persists.

Setup

Two paths — pick one:

Path 1 — You do it yourself (30–60 min) Read SETUP_HUMAN.md. Plain English, no technical background assumed.

Path 2 — Let your agent handle it Paste SETUP_AI.md into your OpenClaw chat. It asks 8 questions and does the install itself.

Prerequisites

OpenClaw running with any model
Python 3.10+
npm install -g mcporter
NVIDIA Developer free tier API key (Kimi K2.5, 131K context, free)
Gemini API key (free) for nightly reconciliation

Adam Framework

Adam Framework

What It Solves

The 5 Layers

The Key Insight

Setup

Prerequisites

Links