MindGardener

Local-first long-term memory for autonomous agents. Built for OpenClaw. Creates wiki knowledge graph from conversations, scores events by surprise, detects conflicts, and assembles token-budget context. Complements OpenClaw's built-in memory_search.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install mindgardener

MindGardener 🌱

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