Sessions and memory
Memoria Honcho
Honcho aggiunge a OpenClaw una memoria nativa per l'IA tramite un Plugin esterno. Salva le conversazioni in un servizio dedicato e crea nel tempo modelli dell'utente e dell'agente, fornendo all'agente un contesto tra sessioni che va oltre i file Markdown dell'area di lavoro.
Cosa offre
- Memoria tra sessioni - le conversazioni vengono conservate dopo ogni turno, così il contesto persiste anche dopo la reimpostazione della sessione, la Compaction e il passaggio da un canale all'altro.
- Modellazione dell'utente - Honcho mantiene un profilo per ogni utente (preferenze, informazioni, stile di comunicazione) e per l'agente (personalità, comportamenti appresi).
- Ricerca semantica - consente di cercare tra le osservazioni ricavate dalle conversazioni precedenti, non solo nella sessione corrente.
- Consapevolezza multi-agente - gli agenti principali tengono automaticamente traccia dei sottoagenti avviati e vengono aggiunti come osservatori nelle sessioni degli agenti secondari.
Strumenti disponibili
Honcho registra strumenti che l'agente può utilizzare durante la conversazione:
Recupero dei dati (rapido, senza chiamate al modello linguistico):
| Strumento | Funzione |
|---|---|
honcho_context |
Rappresentazione completa dell'utente tra le diverse sessioni |
honcho_search_conclusions |
Ricerca semantica tra le conclusioni archiviate |
honcho_search_messages |
Ricerca dei messaggi tra le sessioni (per mittente, data) |
honcho_session |
Cronologia e riepilogo della sessione corrente |
Domande e risposte (basate sul modello linguistico):
| Strumento | Funzione |
|---|---|
honcho_ask |
Pone domande sull'utente. depth='quick' per i fatti, 'thorough' per una sintesi dettagliata |
Per iniziare
Installa il Plugin ed esegui la configurazione:
openclaw plugins install @honcho-ai/openclaw-honchoopenclaw honcho setupopenclaw gateway --forceIl comando di configurazione richiede le credenziali API, scrive la configurazione e, facoltativamente, migra i file di memoria esistenti dell'area di lavoro.
Configurazione
Le impostazioni si trovano in plugins.entries["openclaw-honcho"].config:
{ plugins: { entries: { "openclaw-honcho": { config: { apiKey: "your-api-key", // ometti per l'hosting autonomo workspaceId: "openclaw", // isolamento della memoria baseUrl: "https://api.honcho.dev", }, }, }, },}Per le istanze con hosting autonomo, imposta baseUrl sul server locale (ad
esempio http://localhost:8000) e ometti la chiave API.
Migrazione della memoria esistente
Se disponi di file di memoria esistenti nell'area di lavoro (USER.md,
MEMORY.md, IDENTITY.md, memory/, canvas/), openclaw honcho setup li
rileva e propone di migrarli.
Funzionamento
Dopo ogni turno dell'IA, la conversazione viene salvata in Honcho. Vengono osservati sia i messaggi dell'utente sia quelli dell'agente, consentendo a Honcho di creare e perfezionare i propri modelli nel tempo.
Durante la conversazione, gli strumenti di Honcho interrogano il servizio
tramite l'hook del Plugin before_prompt_build di OpenClaw, inserendo il
contesto pertinente prima che il modello riceva il prompt.
Honcho e la memoria integrata a confronto
| Integrata / QMD | Honcho | |
|---|---|---|
| Archiviazione | File Markdown dell'area di lavoro | Servizio dedicato (locale o in hosting) |
| Tra sessioni | Tramite file di memoria | Automatica e integrata |
| Modellazione dell'utente | Manuale (scrittura in MEMORY.md) | Profili automatici |
| Ricerca | Vettoriale + parole chiave (ibrida) | Semantica sulle osservazioni |
| Multi-agente | Nessun tracciamento | Consapevolezza delle relazioni padre/figlio |
| Dipendenze | Nessuna (integrata) o binario QMD | Installazione del Plugin |
Honcho e il sistema di memoria integrato possono funzionare insieme. Quando QMD è configurato, diventano disponibili strumenti aggiuntivi per cercare nei file Markdown locali insieme alla memoria tra sessioni di Honcho.
Comandi CLI
openclaw honcho setup # Configura la chiave API e migra i fileopenclaw honcho status # Verifica lo stato della connessioneopenclaw honcho ask <question> # Interroga Honcho sull'utenteopenclaw honcho search <query> [-k N] [-d D] # Ricerca semantica nella memoria