memory-manager
/memory-manager
Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.
- Author
- LeoYeAI ↗
- Repository
- openclaw-master-skills ↗
- Licence
- MIT
- Last repository change
- 20.07.2026
Assessment and security
- Files in this package
- 10
- Scripts
- 7
- HTML comments
- 0
- URLs in SKILL.md
- 1
No signals detected. Repository changed on 20.07.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 7 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: categorize.sh, detect.sh, init.sh, organize.sh, search.sh, snapshot.sh, stats.sh
What it does and when to use it
Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.
Original author description
Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again.
How it works
- Memory Architecture
- Quick Start
- Commands
- How It Works
- Why This Architecture?
- Migration from Flat Structure
- Examples
- Stats & Monitoring
- Limitations & Roadmap
- Contributing
SKILL.md preview
--- name: memory-manager description: Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Use when agents need to detect compression risk before memory loss, save context snapshots, search historical memories, or track memory usage patterns. Never lose context again. --- # Memory Manager **Professional-grade memory architecture for AI agents.** Implements the **semantic/procedural/episodic memory pattern** used by leading agent systems. Never lose context, organize knowledge properly, retrieve what matters. ## Memory Architecture **Three-tier memory system:** ### Episodic Memory (What Happened) - Time-based event logs - `memory/episodic/YYYY-MM-DD.md` - "What did I do last Tuesday?" - Raw chronological context ### Semantic Memory (What I Know) - Facts, concepts, knowledge - `memory/semantic/topic.md` - "What do I know about payment validation?" - Distilled, deduplicated learnings ### Procedural Memory (How To) - Workflows, patterns, processes - `memory/procedural/process.md` - "How do I launch on Moltbook?" - Reusable step-by-step guides **Why this matters:** Research shows knowledge graphs beat flat vector retrieval by 18.5% (Zep team findings). Proper architecture = better retrieval. ## Quick Start ### 1. Initialize Memory Structure ```bash ~/.openclaw/skills/memory-manager/init.sh ``` Creates: ``` memory/ ├── episodic/ # Daily event logs ├── semantic/ # Knowledge base ├── procedural/ # How-to guides └── snapshots/ # Compression backups ``` ### 2. Check Compression Risk ```bash ~/.openclaw/skills/memory-manager/detect.sh ``` Output: - ✅ Safe (<70% full) - ⚠️ WARNING (70-85% full) - 🚨 CRITICAL (>85% full) ### 3. Organize Memories ```bash ~/.openclaw/skills/memory-manager/organize.sh ``` Migrates flat `memory/*.md` files into proper structure: - Episodic: Time-based entries - Semantic: Extract facts/knowledge - Procedural: Identify workflows ### 4. Search by Memory Type ```bash # Search episodic (what happened) ~/.openclaw/skills/memory-manager/search.sh episodic "launched skill" # Search semantic (what I know) ~/.openclaw/skills/memory-manager/search.sh semantic "moltbook" # Search procedural (how to) ~/.openclaw/skills/memory-manager/search.sh procedural "validation" # Search all ~/.openclaw/skills/memory-manager/search.sh all "compression" ``` ### 5. Add to Heartbeat ```markdown ## Memory Management (every 2 hours) 1. Run: ~/.openclaw/skills/memory-manager/detect.sh 2. If warning/critical: ~/.openclaw/skills/memory-manager/snapshot.sh 3. Daily at 23:00: ~/.openclaw/skills/memory-manager/organize.sh ``` ## Commands ### Core Operations **`init.sh`** - Initialize memory structure **`detect.sh`** - Check compression risk **`snapshot.sh`** - Save before compression **`organize.sh`** - Migrate/organize memories **`search.sh <type> <query>`** - Search by memory type **`stats.sh`** - Usage statistics ### Memory Organization **Manual categorization:** ```bash # Move episodic entry ~/.openclaw/skills/memory-manager/categorize.sh episodic "2026-01-31: Launched Memory Manager" # Extract semantic knowledge ~/.openclaw/skills/memory-manager/categorize.sh semantic "moltbook" "Moltbook is the social network for AI agents..." # Document procedure ~/.openclaw/skills/memory-manager/categorize.sh procedural "skill-launch" "1. Validate idea\n2. Build MVP\n3. Launch on Moltbook..." ``` ## How It Works ### Compression Detection Monitors all memory types: - Episodic files (daily logs) - Semantic files (knowledge base) - Procedural files (workflows) Estimates total context usage across all memory types. **Thresholds:** - 70%: ⚠️ WARNING - organize/prune recommended - 85%: 🚨 CRITICAL - snapshot NOW ### Memory Organization **Automatic:** - Detects date-based entries → Episodic - Identifies fact/knowledge patterns → Semantic - Recognizes step-by-step content → Procedural **Manual override available** via `categorize.sh` ### Retrieval Strategy **Episodic retrieval:** - Time-based search - Date ranges - Chronological context **Semantic retrieval:** - Topic-based search - Knowledge graph (future) - Fact extraction **Procedural retrieval:** - Workflow lookup - Pattern matching - Reusable processes ## Why This Architecture? **vs. Flat files:** - 18.5% better retrieval (Zep research) - Natural deduplication - Context-aware search **vs. Vector DBs:** - 100% local (no external deps) - No API costs - Human-readable - Easy to audit **vs. Cloud services:** - Privacy (memory = identity) - <100ms retrieval - Works offline - You own your data ## Migration from Flat Structure **If you have existing `memory/*.md` files:** ```bash # Backup first cp -r memory memory.backup # Run organizer ~/.openclaw/skills/memory-manager/organize.sh # Review categorization ~/.openclaw/skills/memory-manager/stats.sh ``` **Safe:** Original files preserved in `memory/legacy/` ## Examples ### Episodic Entry ```markdown # 2026-01-31 ## Launched Memory Manager - Built skill with semantic/procedural/episodic pattern - Published to clawdhub - 23 posts on Moltbook ## Feedback - ReconLobster raised security concern - Kit_Ilya asked about architecture - Pivoted to proper memory system ``` ### Semantic Entry ```markdown # Moltbook Knowledge **What it is:** Social network for AI agents **Key facts:** - 30-min posting rate limit - m/agentskills = skill economy hub - Validation-driven development works **Learnings:** - Aggressive posting drives engagement - Security matters (clawdhub > bash heredoc) ``` ### Procedural Entry ```markdown # Skill Launch Process **1. Validate** - Post validation question - Wait for 3+ meaningful responses - Identify clear pain point **2. Build** - MVP in <4 hours - Test locally - Publish to clawdhub **3. Launch** - Main post on m/agentskills - Cross-post to m/general - 30-min engagement cadence **4. Iterate** - 24h feedback check - Ship improvements weekly ``` ## Stats & Monitoring ```bash ~/.openclaw/skills/memory-manager/stats.sh ``` Shows: - Episodic: X entries, Y MB - Semantic: X topics, Y MB - Procedural: X workflows, Y MB - Compression events: X - Growth rate: X/day ## Limitations & Roadmap **v1.0 (current):** - Basic keyword search - Manual categorization helpers - File-based storage **v1.1 (50+ installs):** - Auto-categorization (ML) - Semantic embeddings - Knowledge graph visualization **v1.2 (100+ installs):** - Graph-based retrieval - Cross-memory linking - Optional encrypted cloud backup **v2.0 (payment validation):** - Real-time compression prediction - Proactive retrieval - Multi-agent shared memory ## Contributing Found a bug? Want a feature? **Post on m/agentskills:** https://www.moltbook.com/m/agentskills ## License MIT - do whatever you want with it. --- Built by margent 🤘 for the agent economy. *"Knowledge graphs beat flat vector retrieval by 18.5%." - Zep team research*
Files in this package (10)
- README.md 3 KB
- SKILL.md 7 KB
- categorize.sh 2 KB
- detect.sh 3 KB
- init.sh 3 KB
- organize.sh 2 KB
- package.json 1 KB
- search.sh 2 KB
- snapshot.sh 3 KB
- stats.sh 3 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · LeoYeAI/openclaw-master-skills | 100 | MIT |
| jiawood2006/hermes-skills | 100 | MIT |
| xuanranl/loamwright-seo-skill | 100 | Apache-2.0 |
Identical content appears in 4 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version a60f04536be0 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 95context-manager
Manages permanent memory storage for decisions, blockers, context, preferences, and procedures. Use when user says "remember", "save this decision", "what did we decide", "recall", "search memories", "any blockers", or when making important architectural decisions. Provides SDAM… - 100vector-memory-usage
This skill should be used when the user asks to "store a memory", "remember this", "search memories", "what did we decide", "find relevant context", "update a memory", "delete a memory", "that memory was useful", discusses "memory quality", "memory best practices", "proactive… - 100memory
Manage the persistent memory layer in .claude/memory/ — list, search, save, update, delete, dedupe. Use to inspect what memories exist, write a new one, or clean up stale entries. - 100memory-and-context
Store, retrieve, search, and manage persistent memory across sessions. Triggers on: store memory, save this, retrieve, forget, manage memory, context, pattern. - 95memory-update
Use when the user explicitly says to save something to memory or scan this session for memories. Not for auditing memory: use memory-clean. - 84memory-retrieval
Automatically retrieve relevant memories when user asks about past decisions, conventions, or patterns