mindgardener

TotalClaw 作者 totalclaw

自主代理的本地优先长期记忆。专为 OpenClaw 打造。从对话中创建 wiki 知识图，对事件进行意外评分，检测冲突，并组装令牌预算上下文。补充 OpenClaw 的内置内存搜索。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~widingmarcus-cyber-mindgardener

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~widingmarcus-cyber-mindgardener/file -o widingmarcus-cyber-mindgardener.md

## 概述（中文）

自主代理的本地优先长期记忆。专为 OpenClaw 打造。从对话中创建 wiki 知识图，对事件进行意外评分，检测冲突，并组装令牌预算上下文。补充 OpenClaw 的内置内存搜索。

## 原文

# 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

```bash
pip install mindgardener
garden init
```

Add to your nightly cron:
```bash
garden extract && garden surprise && garden consolidate
```

Add to session start (BOOTSTRAP.md or heartbeat):
```bash
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](https://github.com/widingmarcus-cyber/mindgardener)
- [PyPI](https://pypi.org/project/mindgardener/)
- 172 tests passing