Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Three-layer persistent memory system (Markdown + ChromaDB vectors + NetworkX knowledge graph) for long-term agent recall across sessions. One-command setup w...
Three-layer persistent memory system (Markdown + ChromaDB vectors + NetworkX knowledge graph) for long-term agent recall across sessions. One-command setup w...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Adds persistent three-layer memory to any OpenClaw workspace. The agent gains semantic recall across sessions β decisions, facts, lessons, and institutional knowledge survive restarts.
LayerTechnologyPurposeL1: MarkdownMEMORY.md + daily logs + reference/Human-readable curated knowledgeL2: VectorChromaDB + all-MiniLM-L6-v2Semantic search across all memoriesL3: GraphNetworkXRelationship traversal between concepts All three layers sync together. The indexer updates L2 and L3 from L1 automatically.
Problem: OpenClaw has its own built-in memory search system, but by default it only indexes MEMORY.md and memory/*.md files. Critical workspace files like SOUL.md (agent directives), AGENTS.md (behavior rules), and PROJECTS.md (active work) are ignored. Impact: Agents can violate explicit directives because they're not found in memory searches. This causes operational failures where agents ignore their own rules. Solution: The configure_openclaw.py script adds a memorySearch configuration block to OpenClaw that indexes all critical workspace files. This makes directive compliance automatic rather than optional.
One command from workspace root: bash skills/persistent-memory/scripts/unified_setup.sh This automatically: β Creates 3-layer memory system (Markdown + Vector + Graph) β Installs all Python dependencies (ChromaDB, NetworkX, sentence-transformers) β Configures OpenClaw memorySearch integration (directive compliance) β Indexes existing MEMORY.md if present β Sets up daily maintenance automation No manual configuration needed. The script handles everything including OpenClaw integration that prevents agents from ignoring workspace directives (SOUL.md, AGENTS.md, etc.).
MEMORY.md β Curated long-term knowledge (decisions, architecture, lessons learned). Update after significant events. memory/YYYY-MM-DD.md β Daily logs. Raw notes of what happened each day. reference/*.md β Institutional facts (people, repos, infrastructure, business rules). The agent's encyclopedia.
vector_memory/venv/bin/python vector_memory/indexer.py The indexer parses MEMORY.md, reference/.md, and memory/.md into vector embeddings and rebuilds the knowledge graph. Run after every edit to keep layers in sync.
vector_memory/venv/bin/python vector_memory/search.py "your query" Returns top-3 semantically similar chunks with source file and section.
vector_memory/venv/bin/python vector_memory/auto_retrieve.py --status Reports sync health: MEMORY.md hash vs indexed state, chunk count, graph size. Use in heartbeats to detect drift.
Add these to AGENTS.md or SOUL.md:
Before answering questions about prior work, decisions, dates, people, or preferences β search memory first. Use memory_search or run auto_retrieve.py with the query. Never say "I don't remember" without checking. CRITICAL: OpenClaw's built-in memory search should now automatically find directive files (SOUL.md, AGENTS.md) if configure_openclaw.py was run. If memory searches are not finding agent rules or workspace directives, the OpenClaw integration is missing or broken.
Before executing any action that references an external identifier (URL, handle, email, repo name, address) β query reference/ files for the exact value. If not found, query vector memory. If still not found, ask the user. Never fabricate identifiers.
After editing MEMORY.md or any file in reference/ or memory/ β re-index: vector_memory/venv/bin/python vector_memory/indexer.py
Add to HEARTBEAT.md: ## Memory Sync Check Run `vector_memory/venv/bin/python vector_memory/auto_retrieve.py --status` and if status is OUT_OF_SYNC, re-index with `vector_memory/venv/bin/python vector_memory/indexer.py`.
Create reference/ in the workspace root as the agent's institutional knowledge base: reference/ βββ people.md β Contacts, roles, communication details βββ repos.md β GitHub repositories, URLs, status βββ infrastructure.md β Hosts, IPs, ports, services βββ business.md β Company info, strategies, rules βββ properties.md β Domain-specific entities (deals, products, etc.) These files are vector-indexed alongside MEMORY.md. The agent queries them before any action involving external identifiers. Facts accumulate over time β the agent that never forgets.
workspace/ βββ MEMORY.md β Curated long-term memory (L1) βββ memory/ β βββ 2026-02-17.md β Daily log β βββ heartbeat-state.json β Sync tracking βββ reference/ β Institutional knowledge (optional) β βββ people.md β βββ ... βββ vector_memory/ βββ indexer.py β Index all markdown into vectors + graph βββ search.py β Semantic search CLI βββ graph.py β NetworkX knowledge graph βββ auto_retrieve.py β Status checker + auto-retrieval βββ chroma_db/ β Vector database (gitignored) βββ memory_graph.json β Knowledge graph (auto-generated) βββ venv/ β Python venv (gitignored)
"No module named chromadb" β Run setup.sh again or activate the venv: source vector_memory/venv/bin/activate OUT_OF_SYNC status β Run the indexer: vector_memory/venv/bin/python vector_memory/indexer.py Empty search results β Check that MEMORY.md has content and the indexer has been run at least once SIGSEGV on indexing β Usually caused by incompatible ML libs. The setup script pins known-good versions. Agent ignoring SOUL.md/AGENTS.md directives β OpenClaw integration missing. Run python skills/persistent-memory/scripts/configure_openclaw.py to fix. Memory searches not finding workspace files β Check OpenClaw configuration: openclaw config get | grep memorySearch "Configuration verification failed" β Restart OpenClaw manually: openclaw gateway restart
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.