MuninnDB Auto-Memory Workflow#

Nutze MuninnDB (MCP-Tools mcp_muninndb_muninn_*) automatisch als primaere Memory-Schicht. Der MCP-Server muninndb ist in der Hermes-Config registriert und immer verfuegbar.

Konfiguration#

• Vault: hermes
• MCP-Tool-Prefix: mcp_muninndb_muninn_
• API-Key: in ~/.muninn/openclaw.key (Bearer-Token)

Session-Start (automatisch)#

Bei jeder neuen Session:

1. mcp_muninndb_muninn_where_left_off(limit=10) — was war zuletzt aktiv?
2. mcp_muninndb_muninn_recall(context=["user preferences", "current project", "recent context"]) — Kontext aus vorherigen Sessions holen
3. Aus dem Ergebnis: relevante Fakten in den Kontext einweben

Waehrend der Session (proaktiv)#

Speichere automatisch wichtige Fakten via mcp_muninndb_muninn_remember:

• Praeferenzen: "Benutzer bevorzugt X"
• Entscheidungen: "Wir haben uns fuer Y entschieden, weil Z"
• Projekt-Kontext: "Aktuelles Projekt ist P mit Stack S"
• Fehlerbehebung: "Bug B wurde durch Loesung L gefixt"
• Zusammenfassungen: Nach komplexen Tasks eine kurze Zusammenfassung speichern

Wann speichern?

• Nachdem der Benutzer eine wichtige Entscheidung teilt
• Nach erfolgreichem Abschluss einer komplexen Task (5+ Tool-Calls)
• Wenn der Benutzer etwas korrigiert oder eine Praeferenz nennt
• Neue Projekt-Infrastruktur/Architektur

Recall bei Unklarheit#

Wenn Du Kontext aus frueheren Sessions brauchst:

1. mcp_muninndb_muninn_recall(context=["<suchbegriff>"], vault="hermes") — semantische Suche
2. mcp_muninndb_muninn_entity(entity_name="<name>") — was wissen wir ueber ein Entity?

Session-Ende (optional, vor /reset oder Session-Wechsel)#

Bei Bedarf: mcp_muninndb_muninn_remember(concept="session-summary-<datum>", content="<Kurzzusammenfassung>", vault="hermes")

Cron-Job: Periodischer Snapshot#

Ein Cron-Job ( MuninnDB Memory Snapshot) speichert alle 30 Minuten einen Kontext-Snapshot:

yaml

cron:
  name: "MuninnDB Memory Snapshot"
  schedule: "every 30m"
  script: "muninndb-memory-snapshot.sh"   # in ~/.hermes/scripts/
  no_agent: true                          # kein LLM, nur Skript
  workdir: "/Users/bits"
  silent_on_success: true                 # nur Fehler melden

Das Skript sammelt: Arbeitsverzeichnis, letzte Hermes-Sessions, Hostname, Timestamp. Bei Erfolg: kein Output (kein Spam). Bei Fehler: Meldung an Benutzer.

Verwaltung:

bash

cronjob action=list                                   # Status
cronjob action=pause job_id=<id>                      # Pausieren
cronjob action=run job_id=<id>                        # Manuelle Ausfuehrung

REST-API Fallback (wenn MCP-Tools noch nicht sichtbar)#

Falls die MCP-Tools ( mcp_muninndb_muninn_*) noch nicht geladen sind (z.B. vor /reset):

bash

MUNINN_URL="http://127.0.0.1:8475"
MUNINN_TOKEN=$(cat ~/.muninn/openclaw.key)

# Speichern
curl -s -X POST "$MUNINN_URL/api/engrams" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MUNINN_TOKEN" \
  -d '{"concept":"kurzer-titel","content":"vollstaendiger text","vault":"hermes"}'

# Suchen
curl -s -X POST "$MUNINN_URL/api/activate" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MUNINN_TOKEN" \
  -d '{"context":["suchbegriff"],"vault":"hermes","max_results":5}'

Vollstaendige Doku: references/setup-companion.md

Wichtige Hinweise#

• Nicht ueberfrachten: Speichere nur substanzielle Fakten, nicht jede Kleinigkeit
• Atomic halten: Ein Konzept pro Speicherung (bessere Recall-Qualitaet)
• Kein Duplikat-Check noetig: MuninnDB erkennt Duplikate selbst und gibt die existierende ID zurueck
• MCP-Tools erscheinen erst nach /reset — bis dahin REST-API nutzen
• mcp_muninndb_muninn_status fuer Vault-Statistiken
• headers-Key (nicht http_headers) im MCP-Config — der native MCP-Client erwartet headers