Runtime del Agente

OpenClaw ejecuta un único runtime de agente embebido derivado de pi-mono.

OpenClaw usa un único directorio de workspace del agente (''agents.defaults.workspace'') como el ''único'' directorio de trabajo (''cwd'') para que el agente lo use con herramientas y contexto.

Sugerencia: Si ''~/.openclaw/openclaw.json'' no existe, usa ''openclaw setup'' para crear e inicializar archivos del workspace.

Guía completa de layout del workspace + backup: ''Workspace del Agente''

Si ''agents.defaults.sandbox'' está habilitado, sesiones no-principales pueden anularlo con:

workspaces por-sesión bajo ''agents.defaults.sandbox.workspaceRoot'' (ver

''Configuración del Gateway'').

Dentro de ''agents.defaults.workspace'', OpenClaw espera estos archivos editables por el usuario:

- ''AGENTS.md'' — instrucciones de operación + "memoria"

- ''SOUL.md'' — persona, límites, tono

- ''TOOLS.md'' — notas de herramientas mantenidas por el usuario (ej., ''imsg'', ''sag'', convenciones)

- ''BOOTSTRAP.md'' — ritual de primera ejecución única (eliminar después de completar)

- ''IDENTITY.md'' — nombre/vibe/emoji del agente

- ''USER.md'' — perfil de usuario + dirección preferida

En el primer inicio de una nueva sesión, OpenClaw inyecta el contenido de estos archivos directamente en el contexto del agente.

Archivos vacíos se omiten. Archivos grandes se recortan y truncan con marcadores para mantener el prompt ligero (lee el archivo para contenido completo).

Si falta un archivo, OpenClaw inyecta una línea de marcador "archivo faltante" (y ''openclaw setup'' creará una plantilla predeterminada segura).

''BOOTSTRAP.md'' solo se crea para ''workspaces completamente nuevos'' (no existen otros archivos bootstrap). Si lo eliminas después de completar el ritual, no debería recrearse en reinicios posteriores.

Para deshabilitar completamente la creación de archivos bootstrap (para workspaces pre-poblados), establece:

{ agent: { skipBootstrap: true } }

Las herramientas core (read/exec/edit/write y herramientas de sistema relacionadas) siempre están disponibles,

sujetas a política de herramientas. ''apply_patch'' es opcional y controlado por

''tools.exec.applyPatch''. ''TOOLS.md'' ''no'' controla qué herramientas existen; esto es

guía sobre cómo quieres que se usen.

OpenClaw carga skills desde tres ubicaciones (workspace gana en conflictos de nombre):

- Empaquetadas (incluidas con la instalación)

- Alojadas/locales: ''~/.openclaw/skills''

- Workspace: ''<workspace>/skills''

Las skills pueden ser restringidas por config/env (ver ''skills'' en ''Configuración del Gateway'').

OpenClaw reutiliza partes del codebase pi-mono (modelos/herramientas), pero la gestión de sesiones, descubrimiento y conexiones de herramientas son todas propiedad de OpenClaw.

- Sin runtime de agente pi-encoded.

- No consulta configuraciones de ''~/.pi/agent'' o ''<workspace>/.pi''.

Los registros de sesión se almacenan como JSONL en:

- ''~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl''

Los IDs de sesión son estables y elegidos por OpenClaw.

No lee carpetas de sesión legacy de Pi/Tau.

Cuando el modo de cola es ''steer'', los mensajes entrantes se inyectan en el turno actualmente

en ejecución. Después de cada llamada de herramienta, se revisa la cola; si existe un mensaje en cola,

las llamadas de herramienta restantes en el mensaje asistente actual se omiten (la herramienta de error

retorna "Omitido debido a mensaje de usuario en cola."), luego el mensaje de usuario en cola

se inyecta antes de la siguiente respuesta del asistente.

Cuando el modo de cola es ''followup'' o ''collect'', los mensajes entrantes se retienen hasta

que el turno actual termina, luego un nuevo turno de agente inicia con el payload en cola. Ver

''Cola'' para modos + comportamiento debounce/throttle.

Los bloques de asistente completados se envían inmediatamente después de que completa el streaming de chunks; sí

''desactivado por defecto'' (''agents.defaults.blockStreamingDefault: "off"'').

Ajusta límites vía ''agents.defaults.blockStreamingBreak'' (''text_end'' vs ''message_end''; predeterminado es text_end).

Controla el chunking de bloques suaves con ''agents.defaults.blockStreamingChunk'' (predeterminado

800–1200 caracteres; prefiere saltos de párrafo, luego nuevas líneas; última oración).

Usa ''agents.defaults.blockStreamingCoalesce'' para fusionar bloques de streaming y reducir

spam de líneas simples (coalescing basado en idle antes de enviar). Canales que no son Telegram requieren

''*.blockStreaming: true'' explícito para habilitar respuestas en bloque.

Emite resúmenes detallados de herramientas al lanzar herramienta (sin debouncing); el UI de control

transmite salida de herramienta vía eventos del agente si están disponibles.

Más detalles: ''Streaming + Blocking''.

Las referencias de modelo en config (ej., ''agents.defaults.model'' y ''agents.defaults.models'') se resuelven dividiendo en el ''primer'' ''/''.

- Usa ''proveedor/modelo'' al configurar modelos.

- Si el ID del modelo mismo contiene ''/'' (estilo OpenRouter), incluye el prefijo de proveedor (ej., ''openrouter/moonshotai/kimi-k2'').

- Si se omite el proveedor, OpenClaw trata la entrada como un alias para el ''proveedor predeterminado'' o modelo (solo válido si no hay ''/'' en el ID del modelo).

Como mínimo, establece:

- ''agents.defaults.workspace''

- ''channels.whatsapp.allowFrom'' (fuertemente recomendado)

---

Ver ''Configuración del Gateway'' para opciones completas.