Contesto

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 breakdownWorkspace: <workspaceDir>Bootstrap max/file: 12,000 charsSandbox: mode=non-main sandboxed=falseSystem prompt (run): 38,412 chars (~9,603 tok) (Project Context 23,901 chars (~5,976 tok)) Injected workspace files:- AGENTS.md: OK | raw 1,742 chars (~436 tok) | injected 1,742 chars (~436 tok)- SOUL.md: OK | raw 912 chars (~228 tok) | injected 912 chars (~228 tok)- TOOLS.md: TRUNCATED | raw 54,210 chars (~13,553 tok) | injected 20,962 chars (~5,241 tok)- IDENTITY.md: OK | raw 211 chars (~53 tok) | injected 211 chars (~53 tok)- USER.md: OK | raw 388 chars (~97 tok) | injected 388 chars (~97 tok)- HEARTBEAT.md: MISSING | raw 0 | injected 0- BOOTSTRAP.md: OK | raw 0 chars (~0 tok) | injected 0 chars (~0 tok) Skills list (system prompt text): 2,184 chars (~546 tok) (12 skills)Tools: read, edit, write, exec, process, browser, message, sessions_send, …Tool list (system prompt text): 1,032 chars (~258 tok)Tool schemas (JSON): 31,988 chars (~7,997 tok) (counts toward context; not shown as text)Tools: (same as above) Session tokens (cached): 14,250 total / ctx=32,000

/context detail

🧠 Context breakdown (detailed)…Top skills (prompt entry size):- frontend-design: 412 chars (~103 tok)- oracle: 401 chars (~101 tok)… (+10 more skills) Top tools (schema size):- browser: 9,812 chars (~2,453 tok)- exec: 6,240 chars (~1,560 tok)… (+N more tools)

/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