Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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):
ToolCosa fa
honcho_contextRappresentazione completa dell’utente tra le sessioni
honcho_search_conclusionsRicerca semantica tra le conclusioni archiviate
honcho_search_messagesTrova messaggi tra le sessioni (filtra per mittente, data)
honcho_sessionCronologia e riepilogo della sessione corrente
Q&A (basato su LLM):
ToolCosa fa
honcho_askFa 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
Il comando di configurazione chiede le tue credenziali API, scrive la configurazione e facoltativamente migra i file di memoria esistenti del workspace.
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",
        },
      },
    },
  },
}
Per istanze self-hosted, punta 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 / QMDHoncho
ArchiviazioneFile Markdown del workspaceServizio dedicato (locale o hosted)
Cross-sessionTramite file di memoriaAutomatica, integrata
Modellazione dell’utenteManuale (scrittura in MEMORY.md)Profili automatici
RicercaVettoriale + parola chiave (ibrida)Semantica sulle osservazioni
Multi-agenteNon tracciatoConsapevolezza padre/figlio
DipendenzeNessuna (integrata) o binario QMDInstallazione del Plugin
Honcho e il sistema di memoria integrato possono lavorare insieme. Quando è configurato QMD, diventano disponibili strumenti aggiuntivi per cercare nei file Markdown locali insieme alla memoria cross-session di Honcho.

​
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