Sessions and memory
Honcho-geheugen
Honcho voegt AI-native geheugen toe aan OpenClaw via een externe plugin. Gesprekken worden opgeslagen in een speciale service en in de loop van de tijd worden gebruikers- en agentmodellen opgebouwd, waardoor je agent sessieoverschrijdende context krijgt die verder gaat dan Markdown-bestanden in de werkruimte.
Wat het biedt
- Sessieoverschrijdend geheugen - gesprekken blijven na elke beurt bewaard, zodat context behouden blijft na het opnieuw instellen van sessies, Compaction en het wisselen van kanaal.
- Gebruikersmodellering - Honcho onderhoudt een profiel voor elke gebruiker (voorkeuren, feiten, communicatiestijl) en voor de agent (persoonlijkheid, aangeleerd gedrag).
- Semantisch zoeken - zoek in observaties uit eerdere gesprekken, niet alleen in de huidige sessie.
- Bewustzijn van meerdere agents - bovenliggende agents volgen automatisch gestarte subagents, waarbij bovenliggende agents als waarnemers aan onderliggende sessies worden toegevoegd.
Beschikbare tools
Honcho registreert tools die de agent tijdens gesprekken kan gebruiken:
Gegevens ophalen (snel, geen LLM-aanroep):
| Tool | Wat deze doet |
|---|---|
honcho_context |
Volledige gebruikersrepresentatie over sessies heen |
honcho_search_conclusions |
Semantisch zoeken in opgeslagen conclusies |
honcho_search_messages |
Berichten in sessies vinden (filteren op afzender, datum) |
honcho_session |
Geschiedenis en samenvatting van de huidige sessie |
Vragen en antwoorden (aangedreven door een LLM):
| Tool | Wat deze doet |
|---|---|
honcho_ask |
Vragen stellen over de gebruiker. depth='quick' voor feiten, 'thorough' voor synthese |
Aan de slag
Installeer de plugin en voer de configuratie uit:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceDe configuratieopdracht vraagt om je API-referenties, schrijft de configuratie en migreert optioneel bestaande geheugenbestanden uit de werkruimte.
Configuratie
Instellingen staan onder 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", }, }, }, },}Laat voor zelfgehoste instanties baseUrl naar je lokale server verwijzen (bijvoorbeeld
http://localhost:8000) en laat de API-sleutel weg.
Bestaand geheugen migreren
Als je bestaande geheugenbestanden in de werkruimte hebt (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), detecteert openclaw honcho setup deze en
biedt aan ze te migreren.
Hoe het werkt
Na elke AI-beurt wordt het gesprek opgeslagen in Honcho. Zowel berichten van de gebruiker als van de agent worden geobserveerd, zodat Honcho zijn modellen in de loop van de tijd kan opbouwen en verfijnen.
Tijdens gesprekken vragen Honcho-tools de service op via de pluginhook
before_prompt_build van OpenClaw, waarbij relevante context wordt ingevoegd voordat het model
de prompt ziet.
Honcho versus ingebouwd geheugen
| Ingebouwd / QMD | Honcho | |
|---|---|---|
| Opslag | Markdown-bestanden in de werkruimte | Speciale service (lokaal of gehost) |
| Sessieoverschrijdend | Via geheugenbestanden | Automatisch, ingebouwd |
| Gebruikersmodellering | Handmatig (schrijven naar MEMORY.md) | Automatische profielen |
| Zoeken | Vector + trefwoord (hybride) | Semantisch in observaties |
| Meerdere agents | Niet bijgehouden | Bewustzijn van bovenliggende/onderliggende agents |
| Afhankelijkheden | Geen (ingebouwd) of QMD-binair bestand | Installatie van plugin |
Honcho en het ingebouwde geheugensysteem kunnen samenwerken. Wanneer QMD is geconfigureerd, komen aanvullende tools beschikbaar om lokale Markdown-bestanden te doorzoeken naast het sessieoverschrijdende geheugen van Honcho.
CLI-opdrachten
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