Inicialización de agentes

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 elegir 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 (valor predeterminado ~/.openclaw/workspace), OpenClaw:

• Crea AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md y BOOTSTRAP.md.
• Hace que el agente siga una secuencia de nacimiento limitada a tres pasos: pregunta cómo se desea llamarlo, comparte una breve frase sobre su esencia o estilo y pregunta si se prefiere el conjunto mínimo recomendado de plugins o la máxima comodidad.
• Guarda dos veces la identidad acordada: en IDENTITY.md y SOUL.md (lo que el agente lee sobre sí mismo) y mediante openclaw agents set-identity (lo que muestran los canales y la interfaz de usuario).
• Lee las recomendaciones de aplicaciones ya almacenadas durante la incorporación sin volver a examinarlas. Los plugins oficiales usan openclaw plugins install <id>; las Skills de ClawHub de terceros siguen requiriendo una aceptación explícita. Una vez procesada la elección, el agente confirma la oferta almacenada para no volver a preguntar.
• Elimina BOOTSTRAP.md cuando el espacio de trabajo parece estar configurado, de modo que el ritual solo se ejecute una vez.

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

Ejecuciones con modelos integrados y locales

Para las ejecuciones con modelos integrados o locales, OpenClaw mantiene BOOTSTRAP.md fuera del contexto privilegiado del sistema. En la primera ejecución interactiva principal, todavía pasa el contenido del archivo mediante el prompt de usuario, para que los modelos que no invoquen 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 inicial limitado en lugar de un saludo genérico.

Omitir el arranque inicial

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

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 inicial se encuentran en esa máquina remota, no en el Mac.

Documentación relacionada

• Incorporación en la aplicación para macOS: Incorporación
• Estructura del espacio de trabajo: Espacio de trabajo del agente
• Contenido de la plantilla: plantilla BOOTSTRAP.md