🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Superlative Memory Manager
πŸ¦€ ClawHub

Superlative Memory Manager

by @tech-immortales-design

Unified memory management combining auto-compaction, tiered storage, semantic recall, and token optimization for efficient, lossless context handling in Open...

Versionv1.0.0
Downloads509
#crypto-defi#legal#productivity
TERMINAL
clawhub install superlative-memory-manager

πŸ“– About This Skill

Superlative Memory Manager 🧠

The ultimate unified memory system for OpenClaw. Combines the best-of-breed memory skills into a seamless, self-optimizing stack.

What It Does

  • Auto-Compaction: Prevents context overflow by proactively compacting at configurable thresholds
  • Tiered Storage: Hot (session), Warm (LanceDB vectors), Cold (Git-notes), Archive (compressed)
  • Semantic Recall: Vector-based retrieval with memory-on-demand style queries
  • Token Optimization: Integrates with token-efficient-agent to minimize usage
  • Zero Data Loss: WAL protocol + git-backup ensures nothing is lost

    • Architecture

    Input β†’ Context Compactor (70%) β†’ Memory Tiering (auto-tier) β†’ Semantic Store (LanceDB)
                                     ↓
                              Memory On-Demand (recall)
                                     ↓
                              Cognitive Memory (multi-store)
                                     ↓
                              Git Notes (permanent decisions)

    Configuration

    Add to your openclaw.json or agent config:

    {
  "skills": {
    "superlative-memory-manager": {
      "enabled": true,
      "compaction": {
        "thresholdTokens": 90000,
        "strategy": "semantic-first",
        "preserveLast": 30
      },
      "tiering": {
        "hotRetention": "session",
        "warmRetention": "30d",
        "coldRetention": "1y",
        "archiveCompression": "gzip"
      },
      "recall": {
        "maxResults": 10,
        "minScore": 0.6,
        "boostRecent": true
      }
    }
  }
}

    Usage

    The skill works automatically once enabled. No manual intervention needed.

    Manual Override (optional)

    # Force compaction now
memory compact --force
    Query semantic memory
    
memory recall "project decisions about database"
    Store important fact (will be tiered appropriately)
    
memory store "User prefers dark mode" --category preference --importance high

    Requirements

    This skill orchestrates existing skills; it does not install them. Ensure these are installed and ready:

  • cognitive-memory
  • memory-tiering
  • context-compactor
  • memory-on-demand
  • (optional) memory-qdrant for vector store

    • Performance

  • Compaction speed: ~200k tokens/sec on modern hardware
  • Recall latency: <100ms for vector search (warm cache)
  • Storage overhead: ~10% for metadata and indexes

    • Monitoring

    The skill emits events:

  • memory.compaction.started
  • memory.compaction.completed (with stats)
  • memory.recall.performed (query, results, latency)
  • memory.tiering.moved (from β†’ to)

    • Subscribe via heartbeat or log monitoring.

    Troubleshooting

    Q: Compaction not happening? A: Check token usage via openclaw status. Ensure compaction.thresholdTokens is below 90k.

    Q: Recall returns irrelevant results? A: Adjust recall.minScore higher (0.7-0.8). Ensure embeddings model is loaded (qdrant).

    Q: Storage growing indefinitely? A: Review tiering retention policies. Cold/Cold tiers may need manual cleanup after expiration.

    Changelog

  • 1.0.0 (2026-03-28): Initial release β€” unified memory orchestration

    • *Built by Aisha πŸ€– β€” because context matters*

    πŸ’‘ Examples

    The skill works automatically once enabled. No manual intervention needed.

    Manual Override (optional)

    # Force compaction now
memory compact --force
    Query semantic memory
    
memory recall "project decisions about database"
    Store important fact (will be tiered appropriately)
    
memory store "User prefers dark mode" --category preference --importance high

    βš™οΈ Configuration

    Add to your openclaw.json or agent config:

    {
  "skills": {
    "superlative-memory-manager": {
      "enabled": true,
      "compaction": {
        "thresholdTokens": 90000,
        "strategy": "semantic-first",
        "preserveLast": 30
      },
      "tiering": {
        "hotRetention": "session",
        "warmRetention": "30d",
        "coldRetention": "1y",
        "archiveCompression": "gzip"
      },
      "recall": {
        "maxResults": 10,
        "minScore": 0.6,
        "boostRecent": true
      }
    }
  }
}

    πŸ“‹ Tips & Best Practices

    Q: Compaction not happening? A: Check token usage via openclaw status. Ensure compaction.thresholdTokens is below 90k.

    Q: Recall returns irrelevant results? A: Adjust recall.minScore higher (0.7-0.8). Ensure embeddings model is loaded (qdrant).

    Q: Storage growing indefinitely? A: Review tiering retention policies. Cold/Cold tiers may need manual cleanup after expiration.