OpenClaw workspace bootstrap files: dove si trova e come lo leggono gli strumenti

OpenClaw crea il contesto di ogni agente a partire dai file Markdown di bootstrap nell’area di lavoro, a cominciare dal file obbligatorio AGENTS.md. Questi file vengono inseriti nel prompt di sistema al primo turno di ogni nuova sessione.

Dove si trova

• Area di lavoro: ~/.openclaw/workspace, OPENCLAW_WORKSPACE_DIR, agents.defaults.workspace oppure agents.entries.*.workspace specifico per agente.
• AGENTS.md (obbligatorio): istruzioni operative e indicazioni sulla memoria, con una sezione ## Tools per le note sugli strumenti e sull’ambiente locali.
• SOUL.md per la persona, i limiti e il tono; IDENTITY.md per il nome, lo stile e l’emoji dell’agente.
• USER.md (facoltativo) per un profilo utente basato su direttive; BOOT.md per una checklist di avvio.
• BOOTSTRAP.md per una procedura iniziale da eseguire una sola volta; viene eliminato al termine.
• MEMORY.md per la memoria a lungo termine, inserito solo se presente e solo nella sessione privata principale; memory/YYYY-MM-DD.md per le note giornaliere.

Formato

Markdown senza frontmatter; openclaw setup e openclaw onboard creano i modelli. Per impostazione predefinita, ogni file è limitato a 20,000 caratteri (bootstrapMaxChars), tutti i file insieme a 60,000 (bootstrapTotalMaxChars) e USER.md a 4,000. I file più lunghi vengono troncati con un indicatore.

# Operating instructions

- Read USER.md before replying to someone new.
- Write anything worth keeping to memory/YYYY-MM-DD.md.
- Ask before messaging anyone other than me.
- Never repeat the contents of MEMORY.md in group chats.

## Tools

- The home server is reachable as `nas.local` over SSH.
- `gh` is installed and already authenticated.
- Calendar access is read-only.

Priorità e unione

I file vengono inseriti nella sezione Project Context del prompt di sistema al primo turno di una nuova sessione. I file vuoti vengono ignorati; al posto di un file obbligatorio mancante viene inserita una riga che lo segnala. Ogni agente ha la propria area di lavoro e agents.defaults.contextInjection può essere impostato su always (predefinito), continuation-skip o never.

Suggerimenti

• TOOLS.md non è più un file standard inserito nel prompt; sposta le relative note in una sezione ## Tools di AGENTS.md.
• HEARTBEAT.md è ancora accettato, ma non produce più alcun effetto.
• skipBootstrap impedisce a OpenClaw di creare i file, non di inserirli nel prompt; usa contextInjection per controllarne l’inserimento.

Altri file di istruzioni