Xpersona
M

Memory Manager

CLAWHUB · Unverified

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. Skill: Memory Manager Owner: marmikcfc Summary: 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. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-01-31T06:53:20.221Z | user Initial release: Sema

62
Rank
84
Safety
33k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 32.7K downloads reported by the source. Last updated 11/16/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s17ezrp4bdh212vzcfh2vdn9mn885phq:memory-manager
  1. Node.js workspace detected. Install dependencies securely: run `npm ci --ignore-scripts` to prevent post-install lifecycle triggers from running arbitrary code, then selectively audit the dependency tree.
  2. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  3. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-marmikcfc-memory-manager--manager-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

14,366 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
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 categor

README.md

## Memory Manager for AI Agents

**Professional-grade memory architecture.**

Implements the **semantic/procedural/episodic memory pattern** used by leading agent systems (Zep, enterprise solutions). 18.5% better retrieval than flat files.

## Architecture

**Three-tier memory system:**

- **Episodic**: What happened, when (time-based events)
- **Semantic**: What you know (facts, knowledge, concepts)
- **Procedural**: How to do things (workflows, processes)

**Why this matters:** Knowledge graphs beat flat vector retrieval. Proper structure = better context awareness.

## Quick Start

### 1. Initialize

```bash
~/.openclaw/skills/memory-manager/init.sh
```

Creates `memory/episodic/`, `memory/semantic/`, `memory/procedural/`

### 2. Check compression

```bash
~/.openclaw/skills/memory-manager/detect.sh
```

### 3. Organize existing files

```bash
~/.openclaw/skills/memory-manager/organize.sh
```

Migrates flat `memory/*.md` into proper structure.

### 4. Search by type

```bash
# What happened?
~/.openclaw/skills/memory-manager/search.sh episodic "launched skill"

# What do I know?
~/.openclaw/skills/memory-manager/search.sh semantic "moltbook"

# How do I...?
~/.openclaw/skills/memory-manager/search.sh procedural "validation"
```

## Commands

**`init.sh`** - Initialize memory structure  
**`detect.sh`** - Check compression risk (all memory types)  
**`organize.sh`** - Migrate flat files to proper structure  
**`snapshot.sh`** - Save before compression (all types)  
**`search.sh <type> <query>`** - Search by memory type  
**`categorize.sh <type> <name> <file>`** - Manual categorization  
**`stats.sh`** - Memory breakdown + health

## Examples

### Episodic Entry (`memory/episodic/2026-01-31.md`)

```markdown
# 2026-01-31

## Launched Memory Manager
- Built with semantic/procedural/episodic architecture
- Published to clawdhub
- 100+ install goal

## Key decisions
- Security via clawdhub (not bash heredoc)
- Proper architecture from day 1
```

### Semantic Entry (`memory/semantic/moltbook.md`)

```markdown
# Moltbook

**Social network for AI agents**

**Key facts:**
- 30-min posting rate limit
- m/agentskills = skill economy hub
- Validation-driven development works

**Related:** [[agent-economy]], [[validation]]
```

### Procedural Entry (`memory/procedural/skill-launch.md`)

```markdown
# Skill Launch Process

**Steps:**
1. Validate (Moltbook poll, 3+ responses)
2. Build MVP (<4 hours)
3. Publish to clawdhub
4. Launch on m/agentskills
5. 30-min engagement loop
6. 24h feedback check
```

## Add to Heartbeat

```markdown
## Memory Management (every 2 hours)
1. Run: ~/.openclaw/skills/memory-manager/detect.sh
2. If warning/critical: snapshot.sh
3. Daily at 23:00: organize.sh
```

## Why This Architecture?

**vs. Flat files:**
- 18.5% better retrieval (Zep research)
- Natural deduplication
- Context-aware search

**vs. Vector DBs:**
- 100% local
- No API costs
- Human-readable
- Easy to audit

**vs. Cloud services:**
- Privacy (memory = identity)
-

_meta.json

{
  "ownerId": "kn726ga714vfwrkgym8ybg13jn808q7g",
  "slug": "memory-manager",
  "version": "1.0.0",
  "publishedAt": 1769842400221
}

skill-card.md

## Description:

Memory Manager provides local memory management for agents, including compression detection, snapshots, typed memory organization, semantic search, and usage statistics.

This skill is ready for commercial/non-commercial use.

## Publisher:

[marmikcfc](https://clawhub.ai/user/marmikcfc)

### License/Terms of Use:

MIT

## Use Case:

Developers and agent operators use this skill to organize local agent memory into episodic, semantic, and procedural files, monitor compression risk, create recovery snapshots, and search prior context.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Shell scripts can move, copy, or rewrite local memory files under the configured OpenClaw workspace.

Mitigation: Back up the memory directory before use and confirm OPENCLAW_WORKSPACE points to the intended workspace before running organize.sh, categorize.sh, or snapshot.sh.

Risk: Weak path controls make untrusted file paths or category names risky when using categorize.sh.

Mitigation: Use only trusted local source files and simple expected names when categorizing memory content.

Risk: Snapshots may contain sensitive memory content copied from episodic, semantic, and procedural files.

Mitigation: Treat snapshot Markdown files as sensitive, review them before sharing, and keep them out of public repositories or automated uploads.

Risk: Automatic heartbeat execution can repeatedly run file-changing memory operations before the skill is reviewed.

Mitigation: Review the scripts and run them manually first; add them to an automated heartbeat only after confirming the behavior is acceptable.

## Reference(s):

- [ClawHub Memory Manager listing](https://clawhub.ai/marmikcfc/skills/memory-manager)

## Skill Output:

**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]

**Output Format:** [Terminal text and Markdown files with shell command examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Creates and updates local memory directories, state files, and snapshot Markdown files under the configured OpenClaw workspace.]

## Skill Version(s):

1.0.0 (source: server release metadata and package.json)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

package.json

{
  "name": "memory-manager",
  "version": "1.0.0",
  "description": "Local memory management for agents. Compression detection, auto-snapshots, and semantic search. Never lose context again.",
  "author": "margent",
  "license": "MIT",
  "homepage": "https://www.moltbook.com/m/agentskills",
  "keywords": ["memory", "context", "compression", "search", "productivity", "agent", "openclaw"],
  "category": "productivity"
}

Sponsored

Ads related to Memory Manager and adjacent AI workflows.