memory-compactor

memory-compactor

Temporal conversational memory compactor for your custom mem0-python-server.

What it does

• pulls conversational memories for one user_id
• clusters by time windows
• detects likely debug-session arcs
• creates a compact summary memory for resolved arcs
• preserves extracted facts (names/phones/emails) in summary + metadata
• deletes older intermediate entries (safe budget + dry-run first)

Safety defaults

• dry-run by default (no writes/deletes)
• keeps recent memories (--min-age-days)
• keeps the latest entry in each compacted cluster
• delete cap per run (--max-deletes)

Run

cd /home/lucky/.openclaw/workspace/memory-compactor
python3 compactor.py --user-id main

Apply changes:

python3 compactor.py --user-id main --apply

Useful options

• --base-url http://192.168.0.200:8420
• --gap-minutes 45
• --min-age-days 2
• --max-deletes 50

Next improvements

• semantic clustering (embeddings) beyond time windows
• better resolution detection (state machine)
• reversible snapshots before apply
• cron wrapper + run history logging