Skill: peti0402/anti-amnesia (version 1.0.0)

--- 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: ```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: ``` 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: ``` 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.

path: templates/HEARTBEAT.md
content: # HEARTBEAT.md

## On Every Wake-Up — Mandatory
1. Read `STATE.md`
2. Read `memory/YYYY-MM-DD.md` (today) — create if missing
3. Read `MEMORY.md`

## 🔍 Health Check (silent = good, report only issues)

### Crons
- `cron list` → check **consecutiveErrors > 0** → alert immediately
- Frequent crons not running >2 hours → alert

### Critical Processes
- [Add your process checks here]

### Gateway
- `openclaw gateway status` → running? if not → alert

## 📝 Documentation
- Everything that happens → write to `memory/YYYY-MM-DD.md`
- New decision → write to MEMORY.md
- Never trust "mental notes" — **file written or it didn't happen**


path: templates/STATE.md
content: # 🗺️ STATE.md — World State
> Read on every session start and every heartbeat.
> **Last updated:** [DATE]

---

## 🟢 Active Projects

### Project 1
- **Status:** ✅ Running / ⚠️ Issues / ❌ Down
- **Details:** [what's happening]
- **Next step:** [what to do next]

### Project 2
- **Status:** [...]
- **Details:** [...]

---

## 🧠 Iron Decisions (must always remember)
| Decision | Date | Source |
|----------|------|--------|
| Example: Always use 5m timeframe | DD.MM | Chat with user |
| Example: Risk per trade = 2% max | DD.MM | DECISIONS.md |

---

## ⚠️ Open Issues
1. [Issue description — what's broken/blocked]

---

## 📁 Critical Files
```
STATE.md              ← This file (read first!)
MEMORY.md             ← Long-term memory
HEARTBEAT.md          ← Wake-up protocol
memory/YYYY-MM-DD.md  ← Daily journals
```


Security scan verdicts — ClawScan: suspicious | static analysis:  | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)