Configuración del System Prompt en OpenClaw

Seguro que te ha pasado: el System Prompt de tu agente crece tanto que el modelo empieza a ignorar instrucciones críticas o se vuelve demasiado lento. Gestionar manualmente qué información inyectar en cada ejecución es un dolor de cabeza que suele terminar en errores de contexto.

OpenClaw soluciona esto construyendo un System Prompt personalizado para cada ejecución. No utiliza el prompt por defecto de otros agentes, sino que ensambla uno propio, compacto y estructurado, para asegurar que el modelo se mantenga enfocado.

Requisitos previos

• Tener OpenClaw instalado en tu entorno de Node.js.
• Un Workspace configurado en agents.defaults.workspace.
• Archivos de identidad (opcional) como AGENTS.md o USER.md.

Inicio rápido

Para empezar a usar el sistema de prompts de OpenClaw, sigue estos pasos:

1. Configura tu Workspace: Define la ruta en tus ajustes para que OpenClaw sepa dónde buscar los archivos de contexto.
2. Prepara los archivos Bootstrap: Crea archivos como AGENTS.md o SOUL.md en tu Workspace. OpenClaw los leerá automáticamente.
3. Define el Timezone: Configura agents.defaults.userTimezone para que el agente entienda tu contexto temporal sin romper la caché del prompt.
4. Ejecuta el agente: OpenClaw inyectará las herramientas (Tooling), la seguridad y el contexto del proyecto de forma automática.

Estructura del Prompt

El prompt de OpenClaw es intencionalmente compacto. Se divide en secciones fijas que incluyen:

• Tooling: Lista de herramientas actuales y descripciones cortas.
• Safety: Recordatorios sobre guardrails para evitar comportamientos no deseados.
• Skills: Instrucciones para que el modelo cargue habilidades bajo demanda.
• Workspace: Ruta del directorio de trabajo actual.
• Current Date & Time: Zona horaria del usuario para mantener la estabilidad de la caché.
• Runtime: Información técnica sobre el host, OS, Node.js y el modelo.

Modos de Prompt

OpenClaw puede generar prompts más pequeños para sub-agentes mediante promptMode:

• full: El modo por defecto con todas las secciones.
• minimal: Omite Skills, Memory Recall, User Identity y Heartbeats. Mantiene el Tooling y el Workspace.
• none: Solo devuelve la línea base de identidad.

Inyección de Archivos Bootstrap

Los archivos del Workspace se recortan y se añaden bajo Project Context. Esto permite que el modelo vea tu perfil sin que tengas que pedirle que lea los archivos manualmente. Los archivos incluidos son:

• AGENTS.md y SOUL.md
• TOOLS.md e IDENTITY.md
• USER.md y HEARTBEAT.md
• BOOTSTRAP.md (solo en workspaces nuevos)

El tamaño máximo por defecto es de 20,000 caracteres, controlado por agents.defaults.bootstrapMaxChars.

Manejo de Skills

Si tienes habilidades disponibles, OpenClaw inyecta una lista compacta con sus rutas:

<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>

El prompt instruye al modelo para usar el comando read y cargar el archivo SKILL.md solo cuando sea necesario.

Solución de problemas

• El prompt es demasiado largo: Revisa el tamaño de tus archivos en el Workspace. OpenClaw truncará los archivos que superen el límite de bootstrapMaxChars.
• El agente no sabe qué hora es: Asegúrate de configurar agents.defaults.userTimezone. Si necesitas la hora exacta con segundos, el agente debe usar session_status, ya que el System Prompt solo incluye la zona horaria para optimizar la caché.
• Faltan secciones en un sub-agente: Esto es normal si el promptMode está en minimal. Las secciones como Skills o Heartbeats se eliminan para ahorrar tokens.
• No se encuentran las herramientas: Verifica que el Tooling esté correctamente definido; si no hay herramientas disponibles, la sección se omitirá.

Para analizar cuánto espacio ocupa cada archivo inyectado o el esquema de las herramientas, utiliza los comandos /context list o /context detail.

¿Necesitas ayuda configurando tus prompts? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Conceptos de Contexto
• Configuración de Date & Time