Biomimetic Memory Architecture

Install, verify, and manage OpenClaw memory with integrated daily distillation, weekly synthesis, procedural learning, retention, and cold archiving workflows.

Audits

Warn

ClawScanWarn

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install biomimetic-memory-architecture

Biomimetic Memory Architecture (BMA)

A biomimetic memory architecture for OpenClaw agents.

When to Use

Use this skill when the user wants to:

install or verify a complete OpenClaw memory architecture
replace separate OpenCortex and Lesson-Imprint skill folders
run daily distillation / weekly synthesis memory governance
reduce long-term memory bloat
audit old memory/archive/ records
design or run retention / forgetting workflows
move metabolized source files out of active memory
keep memory/ clean for memory-wiki indexDailyNotes=true
convert repeated failures into compact behavioral safeguards

Core Rules

Provide the full stack — BMA includes OpenCortex-style structure, daily distillation, weekly synthesis, Lesson-Imprint procedural learning, and retention/forgetting.
Keep promotion and forgetting separate — daily distillation promotes useful current memory; BMA retention metabolizes aged archives later.
Integrate Lesson-Imprint as procedural learning — repeated failures become compact safeguards, not bulky narrative memory.
Default to read-only audit — produce a candidate report before moving, deleting, or rewriting files.
Scan aged candidates only — avoid full-history sweeps; default threshold is records older than 30 days.
Cold archive, not blind deletion — move metabolized source files to memory-archive/ unless the user explicitly approves deletion.
Keep citations — compressed summaries must cite the moved source file path.
Protect active memory — never move projects/, runbooks/, workflows/, contacts/, preferences.md, lesson-imprint/, or today’s daily log.
Verify after action — check file counts, wiki status, and git status after any write phase.

Quick Reference

Task	File
Architecture and lifecycle	`references/architecture.md`
Installation and integration	`references/installation.md`
OpenCortex foundation	`references/opencortex-foundation.md`
Lesson-Imprint component	`references/lesson-imprint.md`
Daily distillation prompt	`references/daily-distillation.md`
Weekly synthesis prompt	`references/weekly-synthesis.md`
Retention scoring rubric	`references/retention-rubric.md`
Read-only audit script	`scripts/bma_retention_audit.py`
Lesson-Imprint CLI	`scripts/lesson_imprint.py`
Install / update / verify	`scripts/install.sh`, `scripts/update.sh`, `scripts/verify.sh`
Vault / metrics / git backup	`scripts/vault.sh`, `scripts/metrics.sh`, `scripts/git-backup.sh`

MVP Workflow

For installation, read references/installation.md first.

# 1. Install (runs system compatibility check + auto-fix guidance)
bash skills/biomimetic-memory-architecture/scripts/install.sh

# 2. If system check shows critical issues:
#    Execute the gateway config.patch commands shown in the output

# 3. Verify
bash skills/biomimetic-memory-architecture/scripts/verify.sh

# 4. Phase 1 retention audit (read-only)
python3 skills/biomimetic-memory-architecture/scripts/bma_retention_audit.py --workspace . --older-than-days 30

See references/installation.md for the complete agent-side installation flow including system config auto-fix.