Honcho aggiunge memoria nativa per l’AI a OpenClaw. Mantiene in modo persistente le
conversazioni 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, così
il contesto si conserva tra reset di sessione, Compaction e cambi di canale.
- Modellazione dell’utente — Honcho mantiene un profilo per ogni 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 padre tracciano automaticamente i
subagenti generati, con i padri aggiunti come osservatori nelle sessioni figlie.
Strumenti disponibili
Honcho registra strumenti che l’agente può usare durante la conversazione:
Recupero dati (veloce, nessuna chiamata LLM):
| Tool | Cosa fa |
|---|
honcho_context | Rappresentazione completa dell’utente tra le sessioni |
honcho_search_conclusions | Ricerca semantica tra le 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 | Fa domande 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ò essere eseguito interamente in locale (self-hosted) oppure tramite l’API gestita su
api.honcho.dev. Per l’opzione self-hosted non sono richieste dipendenze
esterne.
Configurazione
Le impostazioni si trovano sotto plugins.entries["openclaw-honcho"].config:
{
plugins: {
entries: {
"openclaw-honcho": {
config: {
apiKey: "your-api-key", // ometti per self-hosted
workspaceId: "openclaw", // isolamento della memoria
baseUrl: "https://api.honcho.dev",
},
},
},
},
}
baseUrl al tuo server locale (per esempio
http://localhost:8000) e ometti la chiave API.
Migrare la memoria esistente
Se hai file di memoria del workspace esistenti (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 AI, la conversazione viene mantenuta in modo persistente in Honcho. Sia i messaggi dell’utente sia
quelli dell’agente vengono osservati, consentendo a Honcho di costruire e perfezionare i propri modelli nel
tempo.
Durante la conversazione, gli strumenti Honcho interrogano il servizio nella fase before_prompt_build,
iniettando contesto rilevante prima che il modello veda il prompt. Questo garantisce
confini di turno accurati e richiamo pertinente.
Honcho vs memoria integrata
| Integrata / QMD | Honcho |
|---|
| Archiviazione | File Markdown del workspace | Servizio dedicato (locale o hosted) |
| Cross-session | Tramite file di memoria | Automatica, integrata |
| Modellazione dell’utente | Manuale (scrittura in MEMORY.md) | Profili automatici |
| Ricerca | Vettoriale + parola chiave (ibrida) | Semantica sulle osservazioni |
| Multi-agente | Non tracciato | Consapevolezza padre/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
Per approfondire
Correlati
