per-agent-compression-universal

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.

3,891 stars

Best use case

per-agent-compression-universal is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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.

Teams using per-agent-compression-universal should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/per-agent-compression-universal/SKILL.md --create-dirs "https://raw.githubusercontent.com/openclaw/skills/main/skills/bensk2001/per-agent-compression-universal/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/per-agent-compression-universal/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How per-agent-compression-universal Compares

Feature / Agentper-agent-compression-universalStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

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

Related Skills

universal-trading

3891
from openclaw/skills

Execute cross-chain token trading on EVM and Solana with Particle Network Universal Account SDK. Use when users ask to set up universal-account-example, buy or sell tokens, run convert/swap flows, transfer assets, call custom transactions, query balances/history, or monitor transaction status via WebSocket.

Cryptocurrency & DeFi

Universal Video to S3 Uploader

3891
from openclaw/skills

Download videos from YouTube, Twitter/X, TikTok, Douyin, Bilibili and upload to S3-compatible storage. Universal video downloader with smart quality selection and audio merging.

bundled-compression-runtime

3795
from openclaw/skills

Compress or convert generated images for delivery, preview, and social upload. Use when the user asks to compress an image, optimize image size, convert to webp, or reduce file size after generation.

---

3891
from openclaw/skills

name: article-factory-wechat

Content & Documentation

humanizer

3891
from openclaw/skills

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.

Content & Documentation

find-skills

3891
from openclaw/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

General Utilities

tavily-search

3891
from openclaw/skills

Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.

Data & Research

baidu-search

3891
from openclaw/skills

Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.

Data & Research

agent-autonomy-kit

3891
from openclaw/skills

Stop waiting for prompts. Keep working.

Workflow & Productivity

Meeting Prep

3891
from openclaw/skills

Never walk into a meeting unprepared again. Your agent researches all attendees before calendar events—pulling LinkedIn profiles, recent company news, mutual connections, and conversation starters. Generates a briefing doc with talking points, icebreakers, and context so you show up informed and confident. Triggered automatically before meetings or on-demand. Configure research depth, advance timing, and output format. Walking into meetings blind is amateur hour—missed connections, generic small talk, zero leverage. Use when setting up meeting intelligence, researching specific attendees, generating pre-meeting briefs, or automating your prep workflow.

Workflow & Productivity

self-improvement

3891
from openclaw/skills

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge is outdated or incorrect, (6) A better approach is discovered for a recurring task. Also review learnings before major tasks.

Agent Intelligence & Learning

botlearn-healthcheck

3891
from openclaw/skills

botlearn-healthcheck — BotLearn autonomous health inspector for OpenClaw instances across 5 domains (hardware, config, security, skills, autonomy); triggers on system check, health report, diagnostics, or scheduled heartbeat inspection.

DevOps & Infrastructure