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 bleiben nach jedem Gesprächsschritt erhalten, sodass der Kontext über Sitzungszurücksetzungen, Compaction und Kanalwechsel hinweg bestehen bleibt.
- Benutzermodellierung – Honcho verwaltet ein Profil für jeden Benutzer (Präferenzen, Fakten, Kommunikationsstil) und für den Agenten (Persönlichkeit, erlernte Verhaltensweisen).
- Semantische Suche – durchsucht Erkenntnisse aus früheren Unterhaltungen, nicht nur die aktuelle Sitzung.
- Multi-Agenten-Bewusstsein – übergeordnete Agenten verfolgen automatisch erzeugte Unteragenten und werden in untergeordneten Sitzungen als Beobachter hinzugefügt.
Verfügbare Tools
Honcho registriert Tools, die der Agent während der Unterhaltung verwenden kann:
Datenabruf (schnell, ohne LLM-Aufruf):
| Tool | Funktion |
|---|---|
honcho_context |
Vollständige Benutzerdarstellung über Sitzungen hinweg |
honcho_search_conclusions |
Semantische Suche in gespeicherten Schlussfolgerungen |
honcho_search_messages |
Nachrichten sitzungsübergreifend finden (nach Absender und Datum filtern) |
honcho_session |
Verlauf und Zusammenfassung der aktuellen Sitzung |
Fragen und Antworten (LLM-gestützt):
| Tool | Funktion |
|---|---|
honcho_ask |
Fragen zum Benutzer stellen. depth='quick' für Fakten, 'thorough' für Synthesen |
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", // bei Selbsthosting weglassen workspaceId: "openclaw", // Speicherisolierung baseUrl: "https://api.honcho.dev", }, }, }, },}Richten Sie bei selbst gehosteten Instanzen baseUrl auf Ihren lokalen Server (zum Beispiel http://localhost:8000) und lassen Sie den API-Schlüssel weg.
Vorhandenen Speicher migrieren
Wenn Sie über vorhandene Speicherdateien im Arbeitsbereich verfügen (USER.md, MEMORY.md, IDENTITY.md, memory/, canvas/), erkennt openclaw honcho setup diese und bietet ihre Migration an.
Funktionsweise
Nach jedem KI-Gesprächsschritt 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 der Unterhaltung fragen Honcho-Tools den Dienst über den Plugin-Hook before_prompt_build von OpenClaw ab und fügen relevanten Kontext ein, bevor das Modell den Prompt sieht.
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 + Schlüsselwort (hybrid) | Semantisch über Beobachtungen |
| Multi-Agenten | Werden nicht verfolgt | Bewusstsein für über-/untergeordnete Agenten |
| Abhängigkeiten | Keine (integriert) oder QMD-Binärdatei | Plugin-Installation |
Honcho und das integrierte Speichersystem können zusammenarbeiten. Wenn QMD konfiguriert ist, stehen zusätzliche Tools zur Verfügung, um lokale Markdown-Dateien neben Honchos sitzungsübergreifendem Speicher zu durchsuchen.
CLI-Befehle
openclaw honcho setup # API-Schlüssel konfigurieren und Dateien migrierenopenclaw honcho status # Verbindungsstatus prüfenopenclaw honcho ask <question> # Honcho zum Benutzer befragenopenclaw honcho search <query> [-k N] [-d D] # Semantische Suche im Speicher