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=[""], vault="hermes") — semantische Suche
2. mcp_muninndb_muninn_entity(entity_name="") — was wissen wir ueber ein Entity?

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

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

Cron-Job: Periodischer Snapshot

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

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:

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):

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