Per Agent Compression Universal

---

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: - memory - automation - cron - compression - multi-agent capabilities: - memory-consolidation - workspace-isolation - agent-auto-discovery - state-persistence - deduplication 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.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

./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.

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