memory-compression-system

# Memory Compression System v3.0

**Integrated memory management and extreme context compression** for OpenClaw. Combines the best features of memory management and extreme compression into a single, streamlined skill with automatic scheduling.

## Quick Start

```bash
# Install skill
openclaw skill install memory-compression-system

# Enable automatic compression (runs every 6 hours)
scripts/enable.sh

# Check status
scripts/status.sh

# Manual compression
scripts/compress.sh --format ultra

# Search memory
scripts/search.sh "keyword"
```

## Features

### 1. Integrated Memory Management
- **Automatic compression**: Every 6 hours (00:00, 06:00, 12:00, 18:00 UTC)
- **Smart cleanup**: Daily cleanup of old files
- **Search functionality**: Unified search across all memory files
- **Backup system**: Automatic backups before compression

### 2. Three Compression Formats
- **Base64 Compact (B64C)**: Universal compatibility, ~40% reduction
- **Custom Binary (CBIN)**: Optimized binary, ~70% reduction  
- **Ultra Compact (UCMP)**: Extreme compression, ~85% reduction, target ~150 tokens

### 3. Automated Scheduling
- **Single cron job**: No overlapping schedules
- **Configurable**: Adjust frequency and timing
- **Reliable**: Built-in error recovery and logging
- **Efficient**: Minimal resource usage

### 4. Search & Retrieval
- **Unified search**: Across all memory formats
- **Fast indexing**: Real-time search updates
- **Context aware**: Understands compressed formats
- **Export options**: Search results in multiple formats

### 5. ClawHub Ready
- **Standard structure**: Compatible with ClawHub
- **Easy installation**: One-command setup
- **Health checks**: Built-in monitoring
- **Documentation**: Comprehensive guides

## Installation

### Via ClawHub (Recommended)
```bash
openclaw skill search memory-compression-system
openclaw skill install memory-compression-system
```

### Manual Installation
```bash
cd /home/node/.openclaw/workspace/skills
git clone [repository-url] me...

# Memory Compression System

Integrated memory management and extreme context compression for OpenClaw.

## Quick Installation

```bash
# Install via ClawHub
openclaw skill install memory-compression-system
```

## Features

- **Three compression formats**: Base64, Binary, Ultra-Compact
- **Automatic scheduling**: Compression every 6 hours
- **Search functionality**: Unified search across all memory
- **Backup system**: Automatic backups before operations
- **Health monitoring**: Built-in health checks

## Basic Usage

```bash
# Check status
./scripts/status.sh

# Manual compression
./scripts/compress.sh --format ultra

# Search memory
./scripts/search.sh "keyword"

# View logs
./scripts/logs.sh
```

## Documentation

Full documentation available in `SKILL.md`.

## Support

For issues and questions:
1. Check `logs/` directory
2. Run `./scripts/health.sh`
3. Review `examples/troubleshooting.md`

## License

MIT License