MindGardener

Local-first long-term memory for autonomous agents. Built for OpenClaw. Creates wiki knowledge graph from conversations, scores events by surprise, detects c...

Your agents forget everything. This fixes it.

Built for OpenClaw. Complements the built-in memory_search tool.

How It Complements OpenClaw

OpenClaw built-in	MindGardener adds
Search existing memory	Create memory from conversations
Manual MEMORY.md edits	Auto-extract entities → wiki pages
Flat text search	Knowledge graph (triplets + wikilinks)
—	Surprise scoring (unexpected = important)
—	Conflict detection (new info vs old)
—	Multi-agent sync

Features (v1.1)

• 🔍 Provenance tracking — know where every fact came from
• ⚔️ Conflict detection — flags when new info contradicts old
• 🚀 Auto-injection — context ready at session start
• ⏰ Temporal decay — old facts fade unless reinforced
• 🔒 Concurrency — file locks for multi-agent safety
• 🔮 Associative recall — follow wikilinks + graph traversal
• 📊 Confidence levels — not all facts are equally reliable
• 🤝 Multi-agent sync — merge per-agent memories to shared

Quick Start

pip install mindgardener
garden init

Add to your nightly cron:

garden extract && garden surprise && garden consolidate

Add to session start (BOOTSTRAP.md or heartbeat):

garden inject --output RECALL-CONTEXT.md

What Changes From Default OpenClaw?

• New folder: memory/entities/ (wiki pages)
• New file: graph.jsonl (knowledge triplets)
• New file: RECALL-CONTEXT.md (auto-generated context)
• New file: garden.yaml (configuration)

Everything is markdown files. No database. Works offline.

Requirements

• Python 3.10+
• No external APIs required
• For fully local: use garden init --provider ollama

Links

• GitHub
• PyPI
• 172 tests passing