Context Optimizer

OpenClaw Context Optimizer

Reduce context/token usage by 40-60% through intelligent compression and learning.

What is it?

The first OpenClaw skill that intelligently compresses context to reduce token costs by 40-60%. Uses multiple strategies (deduplication, pruning, summarization) and learns what context matters over time. Works seamlessly with Memory System for maximum efficiency.

Key Features

• ⚡ 40-60% Token Savings - Intelligent compression without information loss
• 🧠 Learning System - Adapts to what context matters in your workflow
• 🔄 Multiple Strategies - Dedup, prune, summarize, hybrid
• 💾 Memory Integration - Works with OpenClaw Memory System
• 💰 x402 Payments - Agents can pay for unlimited compressions (0.5 USDT/month)
• 📊 ROI Tracking - Automatically calculates return on investment

Free vs Pro Tier

Free Tier:

• 100 compressions per day
• All compression strategies
• Basic statistics and ROI tracking

Pro Tier (0.5 USDT/month):

• Unlimited compressions
• Advanced learning algorithms
• Priority compression
• Detailed analytics
• Custom compression rules

Installation

claw skill install openclaw-context-optimizer

Commands

# Compress context manually
claw optimize compress "Long context..." --strategy=hybrid

# Show compression stats
claw optimize stats

# View compression history
claw optimize history --limit=10

# Calculate ROI
claw optimize roi

# Open dashboard
claw optimize dashboard

# Subscribe to Pro
claw optimize subscribe

How It Works

1. Hooks into requests - Automatically intercepts context before API calls
2. Analyzes content - Identifies redundant, irrelevant, or summarizable info
3. Applies strategy - Deduplication → Pruning → Summarization
4. Learns patterns - Tracks what context was useful vs. wasted
5. Compresses intelligently - Reduces tokens by 40-60%

Compression Strategies

Deduplication (20-30% savings):

• Removes repeated information across messages
• Best for long conversations with repeated facts

Pruning (30-40% savings):

• Removes low-importance messages (greetings, confirmations)
• Best for conversations with filler content

Summarization (40-60% savings):

• Condenses long exchanges into key points
• Best for technical discussions and planning

Hybrid (40-60% savings - Recommended):

• Combines all strategies intelligently
• Best for most use cases

Use Cases

• Reduce token costs on long conversations
• Compress repeated project context
• Summarize technical discussions
• Remove filler from chat history
• Learn compression patterns over time

Agent Economy

Agents can autonomously evaluate if Pro tier is worth it:

• Cost: 0.5 USDT/month
• Value: Saves 40-60% on token costs
• ROI: If saves >0.5 USDT/month in tokens, it pays for itself

Example:

Original: 5,000 tokens × $0.003/1K = $0.015 per request
Compressed: 2,000 tokens × $0.003/1K = $0.006 per request
Savings: $0.009 per request

60 requests/day = $0.54/day = $16.20/month saved
Pro cost: $0.50/month
Net profit: $15.70/month

See AGENT-PAYMENTS.md for x402 integration details.

Memory System Integration

Works best with OpenClaw Memory System:

• Stores compression patterns as memories
• Learns what context is important over time
• Recalls successful strategies from past sessions
• Combined savings: 50-70%

claw skill install openclaw-memory
claw skill install openclaw-context-optimizer

Privacy & Security

Data Storage:

• All data stored locally in ~/.openclaw/openclaw-context-optimizer/
• SQLite database contains: compression statistics, strategy effectiveness, token savings, timestamps
• Compressed context is NOT stored - only compression metrics
• Dashboard binds to localhost only (127.0.0.1) - not exposed to network
• No external servers or telemetry

Data Retention:

• Free tier: 7 days of compression statistics
• Pro tier: Unlimited retention (configurable)
• You can delete all data anytime: rm -rf ~/.openclaw/openclaw-context-optimizer/

Payment Security:

• x402 payments require explicit user authorization via platform wallet
• No private keys or credentials are stored by this skill
• Payment subscriptions can be cancelled anytime
• IMPORTANT: Review and approve any payment transactions before confirming
• Skill does NOT have autonomous access to your wallet - payments require user consent

What This Skill Can See:

• Context structure: size, redundancy patterns, compressibility
• Compression results: before/after token counts, strategy used
• Does NOT store: actual context content, prompts, or responses

Audit & Trust:

• Open source - audit the code yourself at https://github.com/AtlasPA/openclaw-context-optimizer
• Compression happens locally (no additional API calls)
• Hooks are transparent: request:before, provider:after, session:end

Dashboard

Access web UI at http://localhost:9092:

• Real-time compression statistics
• Token savings over time
• ROI calculation (savings vs. Pro cost)
• Strategy performance comparison
• Compression history with before/after view
• Quota usage and license status

ROI Tracking

Context Optimizer automatically calculates return on investment:

$ claw optimize roi

ROI Analysis (Last 30 Days)
────────────────────────────────
Total compressions: 1,247
Average savings: 60%

Cost without optimizer: $10.28
Cost with optimizer: $4.11
Savings: $6.17

Pro tier cost: $0.50/month
Net savings: $5.67/month
ROI: 1,134% 🎉

Requirements

• Node.js 18+
• OpenClaw v2026.1.30+
• OS: Windows, macOS, Linux
• Optional: OpenClaw Memory System (recommended)

API Reference

# Compress context
POST /api/compress
{
  "agent_wallet": "0x...",
  "context": "Long context...",
  "strategy": "hybrid"
}

# Get stats
GET /api/stats?agent_wallet=0x...

# Get ROI analysis
GET /api/roi?agent_wallet=0x...

# x402 payment endpoints
POST /api/x402/subscribe
POST /api/x402/verify
GET /api/x402/license/:wallet

Statistics Example

Token Savings:
- Original: 3,425,000 tokens
- Compressed: 1,370,000 tokens
- Saved: 2,055,000 tokens (60%)

Cost Savings (30 days):
- Without optimizer: $10.28
- With optimizer: $4.11
- Savings: $6.17

Strategy Performance:
- Hybrid: 60% avg (800 uses)
- Summarization: 55% avg (250 uses)
- Pruning: 35% avg (47 uses)
- Deduplication: 25% avg (150 uses)

Economic Rationale

Should you upgrade to Pro?

If you make enough API calls where 40-60% token savings exceed 0.5 USDT/month, Pro tier pays for itself.

Typical savings:

• Small projects: $2-5/month saved → $1.50-4.50 profit
• Medium projects: $10-20/month saved → $9.50-19.50 profit
• Large projects: $50+/month saved → $49.50+ profit

Links

• Documentation
• Agent Payments Guide
• GitHub Repository
• ClawHub Page

Built by the OpenClaw community | First context optimizer with x402 payments