- name
- per-agent-compression-universal
- version
- 1.4.0
- description
- Zero-config memory consolidation for multi-agent OpenClaw deployments. Auto-discovers agents and registers staggered cron tasks with full state tracking, deduplication, and domain-aware extraction.
- author
- OpenClaw CTO
- license
- MIT
- tags
- capabilities
- entry
- type
- installer
- installScript
- install.sh
- uninstallScript
- uninstall.sh
- postInstallMessage
- Per-agent compression tasks registered for all discovered agents with full state tracking and deduplication. Note: Skill is in active testing; see README for limitations and manual verification steps.
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
cd /root/.openclaw/workspace/skills/per-agent-compression-universal
./install.shThis creates 5 staggered tasks (if you have 5 agents) running Sundays 03:00-05:00 Shanghai time.
What It Does
- Pre-check paths and initialize state
- List daily notes older than 7 days (skip recent)
- Sort oldest first, process up to 5 notes per run
- For each note:
- Read content - Extract factual info (preferences, decisions, personal info) - Append to target files with date headers - Move original to memory/processed/
- Update state file
- Clean working buffer
- 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 (
OFFSETSarray) - Domain context per agent (
DOMAIN_CONTEXTassociative 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
--timeoutin install.sh (default 1200s) - Delivery fails: Verify DingTalk connector configured with
tofield
Uninstall
./uninstall.shRemoves all per_agent_compression_* tasks.
Version
Current: 1.3.4 (fixes STATE_FILE case sensitivity bug)
Support
See README.md for full documentation.