# Memorybox

> Diagnoses bloated MEMORY.md files, splits oversized sections into domain-specific files, archives stale daily logs, and deduplicates content using a 3-tier hierarchy (MEMORY.md → domains/ → archive/). Use when MEMORY.md exceeds 10KB, context pressure is high, or the user asks to clean up, organize, or maintain agent memory files. Works alongside Mem0, Supermemory, QMD, or standalone.

- Skill: `ramsbaby-openclaw-memorybox/memorybox` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ramsbaby-openclaw-memorybox/memorybox`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ramsbaby-openclaw-memorybox/memorybox/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Ramsbaby (https://skillmd.com/u/ramsbaby-openclaw-memorybox)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/ramsbaby-openclaw-memorybox/memorybox

---


# MemoryBox

Zero-dependency memory maintenance tool for OpenClaw agents.

## What It Does

Prevents MEMORY.md bloat by organizing memory into 3 tiers:
- **Tier 1**: MEMORY.md (≤10KB, loaded every session)
- **Tier 2**: memory/domains/*.md (searched on-demand)
- **Tier 3**: memory/archive/ (old daily logs)

Works alongside Mem0, Supermemory, QMD, or standalone. Only touches file structure — never configs or plugins.

## Install

```bash
git clone https://github.com/Ramsbaby/openclaw-memorybox.git
cd openclaw-memorybox && chmod +x bin/memorybox
sudo ln -sf "$(pwd)/bin/memorybox" /usr/local/bin/memorybox
```

## Recommended Workflow

1. Run `memorybox doctor ~/openclaw` — full diagnostic (start here)
2. Run `memorybox split ~/openclaw` — move flagged sections to domain files
3. Verify with `memorybox health ~/openclaw` — target score above 80
4. Run `memorybox archive ~/openclaw` — archive daily logs older than 14 days
5. Run `memorybox dedupe ~/openclaw` — remove duplicate content

Additional commands:
```bash
memorybox stale ~/openclaw     # Detect outdated content
memorybox analyze ~/openclaw   # Section-by-section size breakdown
memorybox suggest ~/openclaw   # Improvement recommendations
memorybox report ~/openclaw    # Before/after token savings
memorybox init ~/openclaw      # Set up 3-tier directory structure
```

## Teach Your Agent

Add to AGENTS.md:

```markdown
## Memory Protocol
- **MEMORY.md** (≤10KB): Core facts only. Loaded everywhere — keep it lean.
- **memory/domains/*.md**: Detailed reference. Use `memory_search` to find.
- **memory/archive/**: Old logs. Rarely needed.
```

## Results

Tested on production (7 Discord channels, 48 crons):
- MEMORY.md: 20KB → 3.5KB (-83%)
- Context pressure: 98% → 7%
- Setup time: 5 minutes

## Links

- GitHub: https://github.com/Ramsbaby/openclaw-memorybox
- Companion: https://github.com/Ramsbaby/openclaw-self-healing