aitbc/skills/memory-manager/SKILL.md

name, description

name	description
memory-manager	Automates memory maintenance: weekly consolidation of daily notes into MEMORY.md, archival of old files (30+ days), and periodic cleanup. Use when needing to organize, summarize, or prune memory storage.

Memory Manager Skill

This skill automates the management of OpenClaw memory files, ensuring important information persists while keeping storage tidy.

What It Does

• Weekly consolidation: Summarizes the past week's daily memory entries and appends a structured summary to MEMORY.md
• Archival: Moves daily memory files older than 30 days to memory/archive/ (compressed)
• Orphan cleanup: Removes empty or corrupted memory files
• Space reporting: Logs disk usage before/after operations

When to Use

• As a scheduled cron job (recommended: weekly)
• Manually when memory files are cluttered
• Before a system backup to reduce size
• After a long session to preserve important insights

Configuration

The skill respects these environment variables:

• MEMORY_DIR: Path to memory directory (default: ./memory in workspace)
• MEMORY_ARCHIVE: Archive directory (default: memory/archive)
• MAX_AGE_DAYS: Age threshold for archival (default: 30)

These can be set in the cron job definition or agent environment.

Quick Start

Manual run

python scripts/consolidate_memory.py

Scheduled run (cron)

openclaw cron add \
  --name "memory-consolidation" \
  --schedule '{"kind":"cron","expr":"0 3 * * 0"}' \
  --payload '{"kind":"systemEvent","text":"Run memory-manager weekly consolidation"}' \
  --sessionTarget main