Skip to main content
Il “contesto” è tutto ciò che OpenClaw invia al modello per un’esecuzione. È limitato dalla finestra di contesto del modello (limite di token). Modello mentale per principianti:
  • Prompt di sistema (creato da OpenClaw): regole, strumenti, elenco delle Skills, ora/ambiente di esecuzione e file dell’area di lavoro inseriti.
  • Cronologia della conversazione: i tuoi messaggi + i messaggi dell’assistente per questa sessione.
  • Chiamate/risultati degli strumenti + allegati: output dei comandi, letture di file, immagini/audio e così via.
Il contesto non equivale alla “memoria”: la memoria può essere archiviata su disco e ricaricata in seguito; il contesto è ciò che si trova nella finestra corrente del modello.

Avvio rapido (ispezionare il contesto)

  • /status → vista rapida di “quanto è piena la mia finestra?” + impostazioni della sessione.
  • /context list → cosa viene inserito + dimensioni approssimative (per file + totali).
  • /context detail → analisi più approfondita: dimensioni per file, per schema degli strumenti, per voce delle Skills, dimensione del prompt di sistema e conteggio dei messaggi della trascrizione che possono essere sottoposti a Compaction.
  • /context map → immagine a mappa ad albero in stile WinDirStat dei contributori al contesto monitorati nella sessione corrente.
  • /usage tokens → aggiunge alle risposte normali un piè di pagina con l’utilizzo per risposta.
  • /compact → riassume la cronologia meno recente in una voce compatta per liberare spazio nella finestra.
Vedi anche: Comandi slash, Utilizzo e costi dei token, Compaction.

Esempio di output

I valori variano in base al modello, al provider, ai criteri degli strumenti e al contenuto dell’area di lavoro.

/context list

/context detail

/context map

Invia un’immagine generata dal rapporto dell’ultima esecuzione memorizzato nella cache e dalla trascrizione della sessione. Prima che un messaggio normale abbia prodotto un rapporto di esecuzione nella sessione, /context map restituisce un messaggio di indisponibilità anziché visualizzare una stima. L’area dei rettangoli è proporzionale ai caratteri monitorati nel prompt:
  • trascrizione della conversazione (messaggi dell’utente, risposte dell’assistente, risultati degli strumenti, riepiloghi della Compaction), oltre al contesto di esecuzione per turno e alle aggiunte al prompt effettuate dagli hook che raggiungono solo il modello
  • file dell’area di lavoro inseriti
  • testo del prompt di sistema di base
  • voci del prompt delle Skills
  • schemi JSON degli strumenti
Il gruppo della conversazione cresce con il progredire della sessione, quindi la mappa cambia a ogni turno; dopo la Compaction si riduce a un riquadro di riepiloghi. /context list, /context detail e /context json possono comunque ispezionare una stima calcolata su richiesta quando non è memorizzato nella cache alcun rapporto di esecuzione.

Cosa viene conteggiato nella finestra di contesto

Tutto ciò che il modello riceve viene conteggiato, inclusi:
  • Prompt di sistema (tutte le sezioni).
  • Cronologia della conversazione.
  • Chiamate agli strumenti + risultati degli strumenti.
  • Allegati/trascrizioni (immagini/audio/file).
  • Riepiloghi della Compaction e artefatti di eliminazione.
  • “Wrapper” del provider o intestazioni nascoste (non visibili, ma comunque conteggiati).

Come OpenClaw crea il prompt di sistema

Il prompt di sistema è gestito da OpenClaw e viene ricreato a ogni esecuzione. Include:
  • Elenco degli strumenti + brevi descrizioni.
  • Elenco delle Skills (solo metadati; vedi sotto).
  • Posizione dell’area di lavoro.
  • Ora (UTC + ora dell’utente convertita, se configurata).
  • Metadati dell’ambiente di esecuzione (host/sistema operativo/modello/ragionamento).
  • File di inizializzazione dell’area di lavoro inseriti in Contesto del progetto.
Analisi completa: Prompt di sistema.

File dell’area di lavoro inseriti (Contesto del progetto)

Per impostazione predefinita, OpenClaw inserisce un insieme fisso di file dell’area di lavoro (se presenti):
  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (solo alla prima esecuzione)
I file di grandi dimensioni vengono troncati singolarmente utilizzando agents.defaults.bootstrapMaxChars (valore predefinito: 20000 caratteri). OpenClaw applica inoltre un limite totale all’inserimento dei file di inizializzazione mediante agents.defaults.bootstrapTotalMaxChars (valore predefinito: 60000 caratteri). /context mostra le dimensioni originali rispetto a quelle inserite e indica se si è verificato un troncamento. Quando si verifica un troncamento, l’ambiente di esecuzione può inserire nel prompt un blocco di avviso nella sezione Contesto del progetto. Configura questo comportamento con agents.defaults.bootstrapPromptTruncationWarning (off, once, always; valore predefinito: always).

Skills: inserite rispetto a caricate su richiesta

Il prompt di sistema include un elenco delle Skills compatto (nome + descrizione + posizione). Questo elenco comporta un sovraccarico effettivo. Le istruzioni delle Skills non sono incluse per impostazione predefinita. Il modello deve eseguire read sul file SKILL.md della Skill solo quando necessario.

Strumenti: esistono due costi

Gli strumenti influiscono sul contesto in due modi:
  1. Testo dell’elenco degli strumenti nel prompt di sistema (ciò che appare come “Strumenti”).
  2. Schemi degli strumenti (JSON). Vengono inviati al modello affinché possa chiamare gli strumenti. Vengono conteggiati nel contesto anche se non sono visibili come testo normale.
/context detail analizza gli schemi degli strumenti più grandi, così puoi vedere quali incidono maggiormente.

Comandi, direttive e “scorciatoie incorporate”

I comandi slash vengono gestiti dal Gateway. Esistono diversi comportamenti:
  • Comandi autonomi: un messaggio contenente solo /... viene eseguito come comando.
  • Direttive: /think, /fast, /verbose, /trace, /reasoning, /elevated, /exec, /model, /queue vengono rimossi prima che il modello riceva il messaggio.
    • I messaggi contenenti solo direttive mantengono le impostazioni della sessione.
    • Le direttive incorporate in un messaggio normale fungono da indicazioni per il singolo messaggio.
  • Scorciatoie incorporate (solo mittenti inclusi nell’elenco consentito): determinati token /... all’interno di un messaggio normale possono essere eseguiti immediatamente (esempio: “ciao /status”) e vengono rimossi prima che il modello riceva il testo restante.
Dettagli: Comandi slash.

Sessioni, Compaction ed eliminazione (cosa persiste)

Ciò che persiste tra i messaggi dipende dal meccanismo:
  • La cronologia normale persiste nella trascrizione della sessione finché non viene sottoposta a Compaction o eliminata in base ai criteri.
  • La Compaction mantiene un riepilogo nella trascrizione e conserva intatti i messaggi recenti.
  • L’eliminazione rimuove i risultati meno recenti degli strumenti dal prompt in memoria per liberare spazio nella finestra di contesto, ma non riscrive la trascrizione della sessione: la cronologia completa resta consultabile su disco.
Documentazione: Sessione, Compaction, Eliminazione della sessione. Per impostazione predefinita, OpenClaw utilizza il motore di contesto legacy integrato per la composizione e la Compaction. Se installi un Plugin che fornisce kind: "context-engine" e lo selezioni con plugins.slots.contextEngine, OpenClaw delega a tale motore la composizione del contesto, /compact e i relativi hook del ciclo di vita del contesto dei sottoagenti. ownsCompaction: false non attiva automaticamente il motore legacy come alternativa; il motore attivo deve comunque implementare correttamente compact(). Consulta Motore di contesto per l’interfaccia collegabile completa, gli hook del ciclo di vita e la configurazione.

Cosa segnala effettivamente /context

Quando disponibile, /context utilizza preferibilmente il rapporto più recente del prompt di sistema creato durante l’esecuzione:
  • System prompt (run) = acquisito dall’ultima esecuzione incorporata (con supporto degli strumenti) e conservato nell’archivio della sessione.
  • System prompt (estimate) = calcolato al momento quando non esiste alcun rapporto di esecuzione (o durante l’esecuzione tramite un backend CLI che non genera il rapporto).
In entrambi i casi segnala le dimensioni e i principali contributori; non mostra il prompt di sistema completo né gli schemi degli strumenti. In modalità dettagliata confronta inoltre la trascrizione della sessione con lo stesso criterio per i messaggi di conversazione effettivi utilizzato dalla Compaction, così è più facile distinguere un utilizzo elevato del prompt/della cache dalla cronologia della conversazione che può essere sottoposta a Compaction.

Contenuti correlati

Context engine

Inserimento personalizzato del contesto tramite Plugin.

Compaction

Riepilogo delle conversazioni lunghe per mantenerle entro la finestra del modello.

System prompt

Come viene creato il prompt di sistema e cosa inserisce a ogni turno.

Agent loop

Il ciclo completo di esecuzione dell’agente, dal messaggio in entrata alla risposta finale.