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#

LayerComponentWhat It Does1Vault injection via SENTINELIdentity files loaded at every boot. Agent wakes up knowing who it is.2memory-core pluginLive memory search mid-session via memory_search / memory_get tools3Neural graph (nmem_context)Associative recall — 12,393 neurons, 40,532 synapses. Concepts link to concepts.4Nightly reconciliationGemini merges daily logs into CORE_MEMORY.md while you sleep. Nothing lost.5Coherence monitorScratchpad 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

Links#

• Repo: https://github.com/strangeadvancedmarketing/Adam
• Live proof (353 sessions): https://strangeadvancedmarketing.github.io/Adam/showcase/ai-amnesia-solved.html
• Full setup guide: https://github.com/strangeadvancedmarketing/Adam/blob/master/SETUP_HUMAN.md