Persistent Memory Hygiene

SkillDocs & knowledge

Keeps OpenClaw's memory store clean, structured, and useful. Use at session end and during periodic maintenance.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Persistent Memory Hygiene skill

What this skill tells your AI

The instructions your AI receives, as published by archieindian/openclaw-superpowers in skills/openclaw-native/persistent-memory-hygiene/SKILL.md and read by ahel’s review.

State file: ~/.openclaw/skill-state/persistent-memory-hygiene/state.yaml

Memory Structure

memory/
  YYYY-MM-DD.md    # Daily notes - raw, comprehensive
MEMORY.md          # Long-term - curated, distilled

When to Write

Write to memory/YYYY-MM-DD.md when:

  • Completing a significant task
  • Making a decision with reasoning
  • Encountering a notable error and its fix
  • At checkpoints on long tasks

Write to MEMORY.md when:

  • Something is worth remembering across months
  • A user preference has been established
  • A pattern has been confirmed

Session Closing Routine

## [HH:MM] Session End
- Completed: [what was finished]
- In progress: [what was started]
- Next: [what to do next session]
- Decisions: [choices made and why]

After writing, update state: last_cleaned_at, memory_line_count, daily_file_count, last_daily_file, status: done.

Hygiene Rules

  • Daily files: write raw, append-only, never edit old entries
  • MEMORY.md: review periodically, remove stale entries, keep under 500 lines

Cron Wakeup Behavior

On 11pm wakeup:

  • Read state file
  • If last_cleaned_at is today's date: skip (already ran)
  • Otherwise: run Session Closing Routine, update state

Signals

GitHub stars
72
Forks
14
Last commit
May 2026
Advanced
Item type
skill
Key
persistent-memory-hygiene
Source
github.com/archieindian/openclaw-superpowers