Sessions and memory
Honcho-Speicher
Honcho erweitert OpenClaw über ein externes Plugin um KI-native Speicherfunktionen. Es speichert Unterhaltungen dauerhaft in einem dedizierten Dienst und erstellt im Laufe der Zeit Benutzer- und Agentenmodelle. Dadurch erhält Ihr Agent sitzungsübergreifenden Kontext, der über Markdown-Dateien im Arbeitsbereich hinausgeht.
Bereitgestellte Funktionen
- Sitzungsübergreifender Speicher – Unterhaltungen werden nach jedem Austausch dauerhaft gespeichert, sodass der Kontext auch nach dem Zurücksetzen von Sitzungen, nach Compaction und beim Wechsel des Kanals erhalten bleibt.
- Benutzermodellierung – Honcho verwaltet ein Profil für jeden Benutzer (Präferenzen, Fakten, Kommunikationsstil) sowie für den Agenten (Persönlichkeit, erlernte Verhaltensweisen).
- Semantische Suche – Durchsuchen Sie Beobachtungen aus früheren Unterhaltungen, nicht nur aus der aktuellen Sitzung.
- Agentenübergreifende Übersicht – Übergeordnete Agenten verfolgen automatisch gestartete Unteragenten und werden in deren Sitzungen als Beobachter hinzugefügt.
Verfügbare Werkzeuge
Honcho registriert Werkzeuge, die der Agent während der Unterhaltung verwenden kann:
Datenabruf (schnell, kein LLM-Aufruf):
| Werkzeug | Funktion |
|---|---|
honcho_context |
Vollständige Benutzerdarstellung über mehrere Sitzungen hinweg |
honcho_search_conclusions |
Semantische Suche in gespeicherten Schlussfolgerungen |
honcho_search_messages |
Sitzungsübergreifende Nachrichtensuche (nach Absender, Datum) |
honcho_session |
Verlauf und Zusammenfassung der aktuellen Sitzung |
Fragen und Antworten (LLM-gestützt):
| Werkzeug | Funktion |
|---|---|
honcho_ask |
Fragen zum Benutzer stellen. depth='quick' für Fakten, 'thorough' für umfassende Auswertungen |
Erste Schritte
Installieren Sie das Plugin und führen Sie die Einrichtung aus:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceDer Einrichtungsbefehl fragt Ihre API-Anmeldedaten ab, schreibt die Konfiguration und migriert optional vorhandene Speicherdateien aus dem Arbeitsbereich.
Konfiguration
Die Einstellungen befinden sich unter plugins.entries["openclaw-honcho"].config:
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // omit for self-hosted workspaceId: "openclaw", // memory isolation baseUrl: "https://api.honcho.dev", }, }, }, },}Legen Sie für selbst gehostete Instanzen unter baseUrl die Adresse Ihres lokalen Servers fest (beispielsweise http://localhost:8000) und lassen Sie den API-Schlüssel weg.
Vorhandenen Speicher migrieren
Wenn in Ihrem Arbeitsbereich bereits Speicherdateien (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/) vorhanden sind, erkennt openclaw honcho setup diese und bietet ihre Migration an.
Funktionsweise
Nach jeder KI-Antwort wird die Unterhaltung dauerhaft in Honcho gespeichert. Sowohl Benutzer- als auch Agentennachrichten werden erfasst, sodass Honcho seine Modelle im Laufe der Zeit erstellen und verfeinern kann.
Während einer Unterhaltung fragen Honcho-Werkzeuge den Dienst über den Plugin-Hook before_prompt_build von OpenClaw ab und fügen relevanten Kontext ein, bevor das Modell den Prompt verarbeitet.
Honcho im Vergleich zum integrierten Speicher
| Integriert / QMD | Honcho | |
|---|---|---|
| Speicherung | Markdown-Dateien im Arbeitsbereich | Dedizierter Dienst (lokal oder gehostet) |
| Sitzungsübergreifend | Über Speicherdateien | Automatisch integriert |
| Benutzermodellierung | Manuell (in MEMORY.md schreiben) | Automatische Profile |
| Suche | Vektor- und Stichwortsuche (hybrid) | Semantisch über Beobachtungen |
| Mehrere Agenten | Keine Erfassung | Übersicht über über-/untergeordnete Agenten |
| Abhängigkeiten | Keine (integriert) oder QMD-Binärdatei | Plugin-Installation |
Honcho und das integrierte Speichersystem können gemeinsam verwendet werden. Wenn QMD konfiguriert ist, stehen zusätzliche Werkzeuge zur Verfügung, mit denen Sie lokale Markdown-Dateien parallel zum sitzungsübergreifenden Speicher von Honcho durchsuchen können.
CLI-Befehle
openclaw honcho setup # Configure API key and migrate filesopenclaw honcho status # Check connection statusopenclaw honcho ask <question> # Query Honcho about the useropenclaw honcho search <query> [-k N] [-d D] # Semantic search over memory