per-agent-compression-universal

# Per-Agent Memory Compression Skill ## Overview This skill automates weekly memory consolidation for multi-agent OpenClaw deployments. It discovers all agents with workspaces and registers staggered cron tasks that compress old daily notes into long-term memory files. ## Key Features - **Auto-discovery**: Finds all agents via `openclaw agents list` - **Workspace isolation**: Each agent compresses its own memory - **State persistence**: Tracks processed notes in `.compression_state.json` - **Deduplication**: Avoids duplicate entries - **Domain awareness**: Includes DOMAIN_CONTEXT for tailored extraction - **Zero config**: Just run `./install.sh` ## Installation ```bash cd /root/.openclaw/workspace/skills/per-agent-compression-universal ./install.sh ``` This creates 5 staggered tasks (if you have 5 agents) running Sundays 03:00-05:00 Shanghai time. ## What It Does 1. Pre-check paths and initialize state 2. List daily notes older than 7 days (skip recent) 3. Sort oldest first, process up to 5 notes per run 4. For each note: - Read content - Extract factual info (preferences, decisions, personal info) - Append to target files with date headers - Move original to `memory/processed/` 5. Update state file 6. Clean working buffer 7. Send DingTalk summary ## File Structure Each agent workspace should have: - `memory/YYYY-MM-DD.md` (daily notes) - `USER.md`, `IDENTITY.md`, `SOUL.md`, `MEMORY.md` (targets) After running: - `memory/.compression_state.json` (state tracking) - `memory/processed/` (moved old notes) ## Customization Edit `install.sh` to adjust: - Stagger offsets (`OFFSETS` array) - Domain context per agent (`DOMAIN_CONTEXT` associative array) - Cron expression (currently Sundays) ## Troubleshooting - **Task hangs**: Check STATE_FILE path uses `{WORKSPACE}` (uppercase), not `{workspace}` - **No notes processed**: Ensure there are daily notes older than 7 days - **Timeout**: Increase `--timeout` in install.sh (default 1200s) - **Delivery fails**: Verify DingTalk connector configured with `to` field ## Uninstall ```bash ./uninstall.sh ``` Removes all `per_agent_compression_*` tasks. ## Version Current: 1.3.4 (fixes STATE_FILE case sensitivity bug) ## Support See README.md for full documentation.