Memory Engine#

Your agent remembers everything. Automatically.

What It Does#

Two hooks passively capture every conversation. No "let me save that" — memory just happens.

text

User sends message → hook auto-stores fact + graph triple + embedding
Agent replies      → hook auto-stores reply (deduped)

Plus 20 tools for search, graph traversal, episode recall, reflection, quality management, backup, and dashboard.

Install#

bash

openclaw plugins install @icex-labs/openclaw-memory-engine
bash ~/.openclaw/extensions/memory-engine/setup.sh
openclaw gateway restart

Setup handles: interactive core memory, legacy data migration, quality pass, maintenance crons, agent instruction patching. One command.

Architecture#

text

Hooks (passive)    → auto-capture messages into archival
Layer 1: Core      → ~500 tokens identity block
Layer 2: Archival  → unlimited facts, 5-signal hybrid search
Layer 3: Graph     → entity relations, auto-extracted
Layer 4: Episodes  → conversation summaries
Layer 5: Reflection→ behavioral pattern analysis

Search#

Five-signal hybrid ranking: keyword (2×) + embedding cosine similarity (5×) + recency + access frequency + importance with forgetting curve.

"Who treats my skin condition?" finds medical records even with zero keyword overlap.

Multi-Agent#

Each agent gets isolated memory via ToolFactory pattern. Session key → agent ID → workspace. Zero config.

Self-Healing#

• Missing embeddings → auto-backfill on restart
• Agent forgets to save → hooks capture passively
• Duplicates → 60s dedup window + weekly cron
• Flat importance → quality pass auto-rates

Tools (20) + Hooks (2)#

Hooks: message:received (auto-capture user messages), message:sent (auto-capture replies)

Core: core_memory_read, core_memory_replace, core_memory_append

Archival: archival_insert, archival_search, archival_update, archival_delete, archival_stats

Graph: graph_query, graph_add

Episodes: episode_save, episode_recall

Intelligence: memory_reflect, archival_deduplicate, memory_consolidate, memory_quality

Admin: memory_export, memory_import, memory_migrate, memory_dashboard

Links#

• npm: @icex-labs/openclaw-memory-engine
• GitHub: icex-labs/openclaw-memory-engine
• License: MIT