Semantic Memory mit openclaw memory verwalten

Ständig verbringt man Zeit damit, nach alten Meeting-Notizen oder Deployment-Details zu suchen. Man weiß, dass die Info irgendwo existiert, aber die klassische Suche findet sie einfach nicht, weil man nicht das exakte Schlagwort parat hat.

Semantische Suche löst dieses Problem, indem sie Inhalte nach ihrer Bedeutung sortiert und auffindbar macht. Mit openclaw memory verwaltest du diesen Index direkt über dein Terminal.

Voraussetzungen

• Ein aktives Memory-Plugin (Standard: memory-core).
• Falls du das Feature deaktivieren möchtest, setze plugins.slots.memory = "none".
• Ein Gateway, das secrets.resolve unterstützt (für den Zugriff auf API Keys via SecretRefs).

Schnellstart

In weniger als fünf Minuten hast du deinen Index im Griff. Hier sind die wichtigsten Befehle für den Start:

1. Status prüfen

Checke zuerst, ob dein Speicher bereit ist. Mit --deep prüfst du zusätzlich die Verfügbarkeit von Vektoren und Embeddings.

openclaw memory status
openclaw memory status --deep

2. Indexierung starten

Damit neue Daten durchsuchbar werden, musst du sie indexieren. Wenn dein Store als “dirty” markiert ist, hilft die Kombination aus Status und Indexierung.

openclaw memory index
# Erzwinge eine vollständige Neuindexierung
openclaw memory index --force

3. Semantische Suche nutzen

Du kannst direkt nach Inhalten suchen. Wenn du sowohl einen Suchbegriff als auch das Flag --query angibst, gewinnt immer der Wert in --query.

openclaw memory search "meeting notes"
openclaw memory search --query "deployment" --max-results 20

Fortgeschrittene Abfragen

Für Automatisierungen oder spezifische Agents kannst du die Ausgabe als JSON anfordern oder die Suche einschränken:

openclaw memory status --json
openclaw memory search --agent main --min-score 0.8

Fehlerbehebung

• Gateway-Probleme: Wenn deine API Keys als SecretRefs gespeichert sind, muss das Gateway erreichbar sein. Falls das Gateway offline ist, schlägt der Befehl sofort fehl.
• Version Skew: Erhältst du einen “unknown-method” Fehler? Dann ist dein Gateway zu alt. Dieses Feature benötigt ein Gateway, das secrets.resolve unterstützt.
• Fehlende Suchbegriffe: Der Befehl memory search bricht mit einem Fehler ab, wenn du weder einen Begriff direkt noch über das --query Flag übergibst.
• Detaillierte Analyse: Nutze das --verbose Flag bei status oder index, um Details zu Providern, Modellen und Batch-Aktivitäten zu sehen.

Hast du Fragen zur Einrichtung oder klemmt es bei der Konfiguration? Der AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

• Memory Konzept
• Plugins