Anti-Amnesia Agent System 🧠🛡️#

Your OpenClaw agent forgets everything between sessions. This skill fixes that.

What It Does#

1. STATE.md — Single source of truth. Active projects, iron decisions, open issues. Read first on every wake-up.
2. Session Memory Hook — Automatically saves full conversation when you /new or /reset. Zero manual work.
3. Daily Journals — memory/YYYY-MM-DD.md files capture everything that happens each day.
4. MEMORY.md — Long-term curated memory. The distilled wisdom, not raw logs.
5. Heartbeat Health Checks — Every wake-up: verify crons, check processes, validate state consistency.
6. Decision Capture — Decisions made in conversation get written to files immediately. No "mental notes."

Setup#

Step 1: Enable Session Memory Hook#

Add to your ~/.openclaw/openclaw.json under hooks:

json

{
  "hooks": {
    "session-memory": {
      "enabled": true,
      "messages": 9999,
      "path": "memory/"
    }
  }
}

Step 2: Create Core Files#

Copy the templates from this skill's templates/ folder to your workspace:

text

templates/STATE.md      → workspace/STATE.md
templates/HEARTBEAT.md  → workspace/HEARTBEAT.md

Edit STATE.md with your actual projects and decisions.

Step 3: Update AGENTS.md#

Add to your AGENTS.md session start protocol:

markdown

## Every Session — Mandatory
1. Read `STATE.md` — current world state
2. Read `memory/YYYY-MM-DD.md` (today) — if missing, create it
3. Read `MEMORY.md` — long-term memory

Step 4: Create memory directory#

bash

mkdir -p workspace/memory

The Anti-Amnesia Protocol#

On Every Session Start:#

text

STATE.md → What's happening now
memory/today.md → What happened today
MEMORY.md → What happened before

On Every Heartbeat:#

text

1. Read STATE.md
2. Check cron health (consecutiveErrors > 0 → alert)
3. Check critical processes (are they running?)
4. Read income-tracker.md (if night shift)
5. Write everything to memory/today.md

On Every Decision:#

text

Decision made in chat → Write to file IMMEDIATELY
No "I'll remember that" — files only

Key Principle#

If it's not in a file, it didn't happen.

Mental notes don't survive session restarts. Files do. Every decision, every status change, every important conversation — write it down in the same response.

Files Reference#

FilePurposeWhen to ReadSTATE.mdCurrent world stateEvery session + heartbeatMEMORY.mdLong-term curated memoryEvery sessionmemory/YYYY-MM-DD.mdDaily journalEvery session + heartbeatHEARTBEAT.mdWake-up protocolEvery heartbeatAGENTS.mdAgent behavior rulesOn first load

Why This Works#

Most OpenClaw agents lose context because they rely on conversation history alone. When context resets, everything is gone.

This system creates external persistent memory — files that survive any reset. Your agent reads them on startup and knows everything within 30 seconds.

Tested in production: 24/7 autonomous trading system, 20+ cron jobs, multi-agent coordination — zero context loss over weeks of operation.