Memoria Honcho
Honcho aggiunge memoria nativa per l’AI a OpenClaw. Mantiene
le conversazioni in modo persistente in un servizio dedicato e costruisce nel tempo modelli dell’utente e dell’agente,
fornendo al tuo agente un contesto cross-session che va oltre i file Markdown
del workspace.
Cosa fornisce
- Memoria cross-session — le conversazioni vengono mantenute in modo persistente dopo ogni turno, quindi
il contesto continua tra reset di sessione, compattazione e cambi di canale.
- Modellazione dell’utente — Honcho mantiene un profilo per ciascun utente (preferenze,
fatti, stile di comunicazione) e per l’agente (personalità, comportamenti
appresi).
- Ricerca semantica — ricerca tra osservazioni di conversazioni passate, non
solo nella sessione corrente.
- Consapevolezza multi-agente — gli agenti genitori tracciano automaticamente i
sotto-agenti generati, con i genitori aggiunti come osservatori nelle sessioni figlie.
Strumenti disponibili
Honcho registra strumenti che l’agente può usare durante la conversazione:
Recupero dati (rapido, senza chiamata LLM):
| Tool | Cosa fa |
|---|
honcho_context | Rappresentazione completa dell’utente tra le sessioni |
honcho_search_conclusions | Ricerca semantica sulle conclusioni archiviate |
honcho_search_messages | Trova messaggi tra le sessioni (filtra per mittente, data) |
honcho_session | Cronologia e riepilogo della sessione corrente |
| Tool | Cosa fa |
|---|
honcho_ask | Fai una domanda sull’utente. depth='quick' per i fatti, 'thorough' per la sintesi |
Per iniziare
Installa il plugin ed esegui la configurazione:
openclaw plugins install @honcho-ai/openclaw-honcho
openclaw honcho setup
openclaw gateway --force
Honcho può funzionare interamente in locale (self-hosted) oppure tramite l’API gestita su
api.honcho.dev. Non sono richieste dipendenze esterne per l’opzione
self-hosted.
Configurazione
Le impostazioni si trovano in 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",
},
},
},
},
}
baseUrl sul tuo server locale (ad esempio
http://localhost:8000) e ometti la chiave API.
Migrazione della memoria esistente
Se hai file di memoria esistenti del workspace (USER.md, MEMORY.md,
IDENTITY.md, memory/, canvas/), openclaw honcho setup li rileva e
offre di migrarli.
La migrazione non è distruttiva — i file vengono caricati su Honcho. Gli originali non vengono
mai eliminati né spostati.
Come funziona
Dopo ogni turno dell’AI, la conversazione viene mantenuta in modo persistente su Honcho. Sia i messaggi dell’utente sia quelli
dell’agente vengono osservati, consentendo a Honcho di costruire e perfezionare nel tempo i propri modelli.
Durante la conversazione, gli strumenti Honcho interrogano il servizio nella fase before_prompt_build,
iniettando contesto pertinente prima che il modello veda il prompt. Questo garantisce
confini di turno accurati e un richiamo pertinente.
Honcho vs memoria integrata
| Integrata / QMD | Honcho |
|---|
| Archiviazione | File Markdown del workspace | Servizio dedicato (locale o ospitato) |
| Cross-session | Tramite file di memoria | Automatico, integrato |
| Modellazione dell’utente | Manuale (scrivere in MEMORY.md) | Profili automatici |
| Ricerca | Vettoriale + parola chiave (ibrida) | Semantica sulle osservazioni |
| Multi-agente | Non tracciato | Consapevolezza genitore/figlio |
| Dipendenze | Nessuna (integrata) o binario QMD | Installazione del plugin |
Comandi CLI
openclaw honcho setup # Configura la chiave API e migra i file
openclaw honcho status # Controlla lo stato della connessione
openclaw honcho ask <question> # Interroga Honcho sull'utente
openclaw honcho search <query> [-k N] [-d D] # Ricerca semantica nella memoria
Ulteriori letture
