Fundamentals

Inicialización del agente

El arranque inicial es el ritual de la primera ejecución que prepara un nuevo espacio de trabajo del agente y guía al agente para que elija una identidad. Se ejecuta una sola vez, justo después de la incorporación, en el primer turno real del agente.

Qué sucede

En la primera ejecución con un espacio de trabajo completamente nuevo (de forma predeterminada, ~/.openclaw/workspace), OpenClaw:

  • Crea AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md y BOOTSTRAP.md.
  • Hace que el agente siga BOOTSTRAP.md: una conversación abierta (no un formulario fijo de preguntas y respuestas) para acordar un nombre, una personalidad y un estilo.
  • Escribe lo que aprende en IDENTITY.md, USER.md y SOUL.md.
  • Elimina BOOTSTRAP.md una vez que el espacio de trabajo parece estar configurado, para que el ritual solo se ejecute una vez.

Un espacio de trabajo se considera configurado cuando SOUL.md, IDENTITY.md o USER.md difiere de su plantilla inicial, o cuando existe una carpeta memory/.

Ejecuciones con modelos integrados y locales

En las ejecuciones con modelos integrados o locales, OpenClaw mantiene BOOTSTRAP.md fuera del contexto privilegiado del sistema. En la primera ejecución interactiva principal, aun así pasa el contenido del archivo mediante el mensaje del usuario, para que los modelos que no utilizan de forma fiable la herramienta read puedan completar el ritual. Si la ejecución actual no puede acceder de forma segura al espacio de trabajo, el agente recibe una breve nota de arranque limitado en lugar de un saludo genérico.

Omitir el arranque inicial

Para omitirlo en un espacio de trabajo preparado previamente, ejecute:

bash
openclaw onboard --skip-bootstrap

Dónde se ejecuta

El arranque inicial siempre se ejecuta en el host del Gateway. Si la aplicación para macOS se conecta a un Gateway remoto, el espacio de trabajo y sus archivos de arranque se encuentran en esa máquina remota, no en el Mac.

Documentación relacionada

Was this useful?
On this page

On this page