memory-guardian
Agent workspace memory lifecycle management via 10 MCP tools + batch maintenance. Manages MEMORY.md, memory/ directory, meta.json, quality gate, Bayesian decay, case lifecycle, and compaction. Use when: (1) Installing or configuring memory-guardian, (2) Running scheduled or on-demand memory maintenance, (3) Diagnosing memory bloat, quality anomalies, or case invalidation, (4) Writing, querying, or archiving memories, (5) Reviewing or retiring judgment cases, (6) Checking quality gate state or L3 confirmations. Triggers on: memory_status, memory_decay, memory_ingest, memory_compact, quality_check, case_query, case_review, run_batch, memory_sync, meta.json, MEMORY.md, memory-guardian.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/5rbdmak7f-alt/memory-guardian-agentmemory-guardian
Workspace memory lifecycle system. Dual-layer Bayesian decay + four-state quality gate + case lifecycle + compaction.
Design Principles
- Check status before any write —
memory_statusfirst - Dry-run before apply — preview destructive operations
- Default behavior > toggles — workspace defaults from
MG_WORKSPACE - Write ordering > content correctness — sequence matters
- Observable but not brittle — signal degradation → WARNING, not crash
- Single source of truth — all defaults in
mg_schema/meta_defaults.py
MCP Tools (10)
workspace defaults from MG_WORKSPACE env var; only non-default params listed.
Query
memory_status()— System overview (memory count / gate state / case summary / references integrity)memory_query(type="active", min_score=0.3)— Search memories (keyword/memory_type filter)
Write
memory_ingest(content="...", importance="auto", tags=[])— Create new memorymemory_decay(lambda=0.01, dry_run=false)— Run five-track Bayesian decay
Audit
quality_check(layer="all")— Quality gate (retire_rate / similar_case_signal / stale_cases)case_query(filter="frozen")— Query cases (active/frozen/retired/stale/ignored)case_review(case_id, action="retire", origin_type="agent_initiated")— Case operations (active/frozen/retired/unfreeze/ignore)
Batch
run_batch(skip_compact=true, dry_run=false, timeout=300)— Full maintenance (includes sync + signal merge)memory_sync(dry_run=true)— Sync file changes → meta.json (auto-run in run_batch)memory_compact(dry_run=true, aggressive=false)— Compact MEMORY.md
Workflows
New Installation
memory_status→ confirmreferences.complete: true- If false, create missing files per the missing list, re-verify
- Create cron task (see signal-loop.md for cron template)
- Manually trigger once to verify
Daily Maintenance (cron)
run_batch(skip_compact=true) runs automatically. Includes:
- memory_sync (incremental file scan)
- Signal merge (access_log + cron inference)
- Decay + quality gate check
- Compact triggers only when MEMORY.md > 15KB
Diagnostics
D1: Memory bloat → memory_compact(dry_run=true) → apply if needed → see compaction.md
D2: Quality anomaly → quality_check(layer="all") → see error_recovery.md
D3: Case invalidation → case_query(filter="stale") → case_review(action="retire"|"active"|"unfreeze") → see case-management.md
Signal Loop (v0.4.6)
Dual-layer access signals feed the decay engine:
- Layer 1 (weight 1.0):
access_log.jsonl— agent appends aftermemory_get - Layer 2 (weight 0.5): cron keyword inference from daily notes
- Health check auto-degrades to Layer 2 if access_log stale > 24h
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-5rbdmak7f-alt-memory-guardian-agent": {
"enabled": true,
"auto_update": true
}
}
}