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.

“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 Skills, ora/runtime e file dell’area di lavoro iniettati.
  • 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, ecc.
Il contesto non è la stessa cosa della “memoria”: la memoria può essere salvata 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 “quanto è piena la mia finestra?” + impostazioni della sessione.
  • /context list → cosa è iniettato + dimensioni approssimative (per file + totali).
  • /context detail → analisi più approfondita: dimensioni per file, per schema di strumento, per voce Skill e dimensione del prompt di sistema.
  • /context map → immagine treemap in stile WinDirStat dei contributori al contesto tracciati della sessione corrente.
  • /usage tokens → aggiunge alle risposte normali un piè di pagina con l’uso per risposta.
  • /compact → riassume la cronologia più vecchia in una voce compatta per liberare spazio nella finestra.
Vedi anche: Comandi slash, Uso dei token e costi, Compaction.

​
Output di esempio

I valori variano in base a modello, provider, criterio degli strumenti e contenuto della tua area di lavoro.

​
/context list

🧠 Context breakdown
Workspace: <workspaceDir>
Bootstrap max/file: 12,000 chars
Sandbox: mode=non-main sandboxed=false
System 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 report dell’ultima esecuzione memorizzato nella cache. Prima che un messaggio normale abbia prodotto un report di esecuzione nella sessione, /context map restituisce un messaggio di indisponibilità invece di renderizzare una stima. L’area del rettangolo è proporzionale ai caratteri del prompt tracciati:
  • file dell’area di lavoro iniettati
  • testo del prompt di sistema di base
  • voci dei prompt Skill
  • schemi JSON degli strumenti
/context list, /context detail e /context json possono comunque ispezionare una stima su richiesta quando nessun report di esecuzione è memorizzato nella cache.

​
Cosa conta nella finestra di contesto

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

​
Come OpenClaw costruisce il prompt di sistema

Il prompt di sistema è di proprietà di OpenClaw e viene ricostruito a ogni esecuzione. Include:
  • Elenco degli strumenti + brevi descrizioni.
  • Elenco Skills (solo metadati; vedi sotto).
  • Posizione dell’area di lavoro.
  • Ora (UTC + ora utente convertita, se configurata).
  • Metadati di runtime (host/OS/modello/thinking).
  • File bootstrap dell’area di lavoro iniettati sotto Contesto del progetto.
Analisi completa: Prompt di sistema.

​
File dell’area di lavoro iniettati (Contesto del progetto)

Per impostazione predefinita, OpenClaw inietta 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 per file usando agents.defaults.bootstrapMaxChars (predefinito 12000 caratteri). OpenClaw applica anche un limite totale di iniezione bootstrap su tutti i file con agents.defaults.bootstrapTotalMaxChars (predefinito 60000 caratteri). /context mostra le dimensioni grezze rispetto a iniettate e se è avvenuto un troncamento. Quando avviene il troncamento, il runtime può iniettare nel prompt un blocco di avviso sotto Contesto del progetto. Configuralo con agents.defaults.bootstrapPromptTruncationWarning (off, once, always; predefinito once).

​
Skills: iniettate rispetto a caricate su richiesta

Il prompt di sistema include un elenco Skills compatto (nome + descrizione + posizione). Questo elenco ha un overhead reale. Le istruzioni delle Skill non sono incluse per impostazione predefinita. Ci si aspetta che il modello esegua read dello SKILL.md della Skill solo quando necessario.

​
Strumenti: ci sono due costi

Gli strumenti incidono sul contesto in due modi:
  1. Testo dell’elenco degli strumenti nel prompt di sistema (ciò che vedi come “Strumentazione”).
  2. Schemi degli strumenti (JSON). Vengono inviati al modello in modo che possa chiamare gli strumenti. Contano nel contesto anche se non li vedi come testo semplice.
/context detail analizza gli schemi degli strumenti più grandi, così puoi vedere cosa domina.

​
Comandi, direttive e “scorciatoie inline”

I comandi slash sono gestiti dal Gateway. Esistono alcuni comportamenti diversi:
  • Comandi autonomi: un messaggio che contiene solo /... viene eseguito come comando.
  • Direttive: /think, /verbose, /trace, /reasoning, /elevated, /model, /queue vengono rimosse prima che il modello veda il messaggio.
    • I messaggi composti solo da direttive mantengono le impostazioni della sessione.
    • Le direttive inline in un messaggio normale agiscono come suggerimenti per singolo messaggio.
  • Scorciatoie inline (solo mittenti allowlist): determinati token /... dentro un messaggio normale possono essere eseguiti immediatamente (esempio: “hey /status”) e vengono rimossi prima che il modello veda il testo rimanente.
Dettagli: Comandi slash.

​
Sessioni, Compaction e pruning (cosa persiste)

Ciò che persiste tra i messaggi dipende dal meccanismo:
  • Cronologia normale persiste nella trascrizione della sessione finché non viene sottoposta a Compaction/pruning secondo il criterio.
  • Compaction persiste un riepilogo nella trascrizione e mantiene intatti i messaggi recenti.
  • Pruning elimina i vecchi risultati degli strumenti dal prompt in memoria per liberare spazio nella finestra di contesto, ma non riscrive la trascrizione della sessione: la cronologia completa resta comunque ispezionabile su disco.
Documentazione: Sessione, Compaction, Pruning della sessione. Per impostazione predefinita, OpenClaw usa il motore di contesto integrato legacy per assemblaggio e Compaction. Se installi un plugin che fornisce kind: "context-engine" e lo selezioni con plugins.slots.contextEngine, OpenClaw delega invece a quel motore l’assemblaggio del contesto, /compact e gli hook correlati del ciclo di vita del contesto dei subagent. ownsCompaction: false non esegue un fallback automatico al motore legacy; il motore attivo deve comunque implementare correttamente compact(). Vedi Motore di contesto per l’interfaccia pluggable completa, gli hook del ciclo di vita e la configurazione.

​
Cosa riporta realmente /context

/context preferisce il report del prompt di sistema costruito dall’esecuzione più recente, quando disponibile:
  • System prompt (run) = catturato dall’ultima esecuzione incorporata (capace di usare strumenti) e persistito nello store della sessione.
  • System prompt (estimate) = calcolato al volo quando non esiste alcun report di esecuzione (o quando si esegue tramite un backend CLI che non genera il report).
In entrambi i casi, riporta dimensioni e principali contributori; non scarica il prompt di sistema completo né gli schemi degli strumenti.

​
Correlati

Motore di contesto

Iniezione di contesto personalizzata tramite plugin.

Compaction

Riassumere conversazioni lunghe per mantenerle all’interno della finestra del modello.

Prompt di sistema

Come viene costruito il prompt di sistema e cosa inietta a ogni turno.

Ciclo dell'agent

Il ciclo completo di esecuzione dell’agent, dal messaggio in ingresso alla risposta finale.