Skip to main content
Il bootstrap è il rituale della prima esecuzione che inizializza lo spazio di lavoro di un nuovo agente e guida l’agente nella scelta di un’identità. Viene eseguito una sola volta, subito dopo l’onboarding, durante il primo turno effettivo dell’agente.

​
Cosa accade

Alla prima esecuzione in uno spazio di lavoro completamente nuovo (predefinito ~/.openclaw/workspace), OpenClaw:
  • Inizializza AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md e BOOTSTRAP.md.
  • Fa seguire all’agente le istruzioni di BOOTSTRAP.md: una conversazione in forma libera (non un modulo fisso di domande e risposte) per concordare nome, personalità e stile.
  • Scrive ciò che apprende in IDENTITY.md, USER.md e SOUL.md.
  • Elimina BOOTSTRAP.md quando lo spazio di lavoro risulta configurato, così il rituale viene eseguito una sola volta.
Uno spazio di lavoro è considerato configurato quando SOUL.md, IDENTITY.md o USER.md si discosta dal relativo modello iniziale oppure esiste una cartella memory/.
BOOTSTRAP.md descrive l’intera conversazione sull’identità. Consultane il contenuto nel modello BOOTSTRAP.md.

​
Esecuzioni con modelli incorporati e locali

Per le esecuzioni con modelli incorporati o locali, OpenClaw esclude BOOTSTRAP.md dal contesto di sistema privilegiato. Durante la prima esecuzione interattiva principale, trasmette comunque il contenuto del file tramite il prompt utente, affinché anche i modelli che non chiamano in modo affidabile lo strumento read possano completare il rituale. Se l’esecuzione corrente non può accedere in sicurezza allo spazio di lavoro, l’agente riceve una breve nota di bootstrap limitato anziché un saluto generico.

​
Come saltare il bootstrap

Per saltarlo in uno spazio di lavoro già inizializzato, esegui:

​
Dove viene eseguito

Il bootstrap viene sempre eseguito sull’host del Gateway. Se l’app macOS si connette a un Gateway remoto, lo spazio di lavoro e i relativi file di bootstrap risiedono su quella macchina remota, non sul Mac.
Quando il Gateway viene eseguito su un’altra macchina, modifica i file dello spazio di lavoro sull’host del Gateway (ad esempio, user@gateway-host:~/.openclaw/workspace).

​
Documentazione correlata