anti-amnesia

name	anti-amnesia
description	Complete anti-amnesia system for OpenClaw agents. Prevents context loss across sessions with structured state files, automatic session saving, health monitoring, and decision tracking. Your agent wakes up knowing everything — every time.
version	1.0.0

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:

{
  "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:

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:

## 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

mkdir -p workspace/memory

The Anti-Amnesia Protocol

On Every Session Start:

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

On Every Heartbeat:

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:

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

File	Purpose	When to Read
STATE.md	Current world state	Every session + heartbeat
MEMORY.md	Long-term curated memory	Every session
memory/YYYY-MM-DD.md	Daily journal	Every session + heartbeat
HEARTBEAT.md	Wake-up protocol	Every heartbeat
AGENTS.md	Agent behavior rules	On 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.