Install
openclaw skills install memory-engine-guideMemGPT-style persistent memory with passive auto-capture — your agent remembers everything automatically. 20 tools + 2 hooks. Five-layer architecture: core identity, archival facts with hybrid semantic search, knowledge graph, episodic conversation recall, and behavioral reflection. No manual tool calls needed — hooks capture every message. TRIGGER when: agent needs to recall past conversations, answer factual questions about the user, search memory, manage core identity, generate dashboard, or run quality pass. DO NOT TRIGGER for: in-session context, or tasks unrelated to memory.
openclaw skills install memory-engine-guideYour agent remembers everything. Automatically.
Two hooks passively capture every conversation. No "let me save that" — memory just happens.
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.
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.
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
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.
Each agent gets isolated memory via ToolFactory pattern. Session key → agent ID → workspace. Zero config.
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