Tiempo de ejecución del agente

OpenClaw ejecuta un single embedded agent runtime (único tiempo de ejecución de agente integrado) - un proceso de agente por Gateway, con su propio workspace, archivos de arranque y almacenamiento de sesiones. Esta página cubre ese contrato de tiempo de ejecución: qué debe contener el workspace, qué archivos se inyectan y cómo las sesiones se inician sobre él.

Espacio de trabajo (obligatorio)

OpenClaw utiliza un único directorio de espacio de trabajo del agente (agents.defaults.workspace) como el único directorio de trabajo (cwd) para herramientas y contexto.

Recomendado: use openclaw setup para crear ~/.openclaw/openclaw.json si falta e inicializar los archivos del espacio de trabajo.

Diseño completo del área de trabajo + guía de copia de seguridad: Agente área de trabajo

Si agents.defaults.sandbox está habilitado, las sesiones que no son principales pueden anular esto con áreas de trabajo por sesión bajo agents.defaults.sandbox.workspaceRoot (consulte Configuración de Gateway).

Archivos de arranque (inyectados)

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 (eliminado después de completarse)
IDENTITY.md - nombre/vibración/emoji del agente
USER.md - perfil de usuario + dirección preferida

En el primer turno de una nueva sesión, OpenClaw inyecta el contenido de estos archivos en el Contexto del Proyecto del prompt del sistema.

Los archivos en blanco se omiten. Los archivos grandes se recortan y truncan con un marcador para que las solicitudes se mantengan ligeras (lea el archivo para obtener el contenido completo).

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

BOOTSTRAP.md solo se crea para un brand new workspace (espacio de trabajo totalmente nuevo) (no hay otros archivos de arranque presentes). Mientras está pendiente, OpenClaw lo mantiene en el Contexto del Proyecto y agrega orientación de arranque del prompt del sistema para el ritual inicial en lugar de copiarlo en el mensaje del usuario. Si lo elimina después de completar el ritual, no debería recrearse en reinicios posteriores.

Después de que se ha observado un área de trabajo, OpenClaw también mantiene un marcador de certificación de directorio de estado para la ruta del área de trabajo. Si un área de trabajo certificada recientemente desaparece o se borra, el inicio se niega a volver a sembrar silenciosamente BOOTSTRAP.md; restaure el área de trabajo o use un restablecimiento de embarque completo para que el área de trabajo y el marcador se borren juntos.

Para deshabilitar completamente la creación de archivos de arranque (para áreas de trabajo presembradas), configure:

{ agents: { defaults: { skipBootstrap: true } } }

Herramientas integradas

Las herramientas principales (leer/ejecutar/editar/escribir y herramientas del sistema relacionadas) siempre están disponibles, sujetas a la política de herramientas. apply_patch es opcional y está limitada por tools.exec.applyPatch. TOOLS.md no controla qué herramientas existen; es orientación sobre cómo usted quiere que se usen.

Habilidades

OpenClaw carga habilidades desde estas ubicaciones (precedencia más alta primero):

Área de trabajo: <workspace>/skills
Habilidades del agente del proyecto: <workspace>/.agents/skills
Habilidades del agente personal: ~/.agents/skills
Administrado/local: ~/.openclaw/skills
Empaquetado (enviado con la instalación)
Carpetas de habilidades adicionales: skills.load.extraDirs

Las raíces de habilidades pueden contener carpetas agrupadas como <workspace>/skills/personal/foo/SKILL.md; la habilidad aún se expone por su nombre de frontmatter plano, por ejemplo foo.

Las habilidades pueden estar limitadas por config/env (consulte skills en Configuración de Gateway).

Límites de tiempo de ejecución

El tiempo de ejecución del agente integrado es propiedad de OpenClaw: el descubrimiento de modelos, el cableado de herramientas, el ensamblaje de avisos, la gestión de sesiones y la entrega de canales comparten una superficie de tiempo de ejecución integrada.

Sesiones

Las transcripciones de las sesiones se almacenan como JSONL en:

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

El ID de sesión es estable y lo elige OpenClaw. No se leen las carpetas de sesión heredadas de otras herramientas.

Dirección durante la transmisión

De forma predeterminada, los mensajes entrantes que llegan a mitad de la ejecución se redirigen a la ejecución actual. La dirección se entrega después de que el turno actual del asistente termine de ejecutar sus llamadas a herramientas, antes de la siguiente llamada al LLM, y ya no omite las llamadas a herramientas restantes del mensaje actual del asistente.

/queue steer es el comportamiento predeterminado de ejecución activa. /queue followup y /queue collect hacen que los mensajes esperen un turno posterior en lugar de redirigir. /queue interrupt aborta la ejecución activa en su lugar. Consulte Queue y Steering queue para conocer el comportamiento de cola y límites.

La transmisión por bloques envía bloques completados del asistente tan pronto como terminan; está desactivada de forma predeterminada (agents.defaults.blockStreamingDefault: "off"). Ajuste el límite mediante agents.defaults.blockStreamingBreak (text_end vs message_end; el valor predeterminado es text_end). Controle la fragmentación de bloques suaves con agents.defaults.blockStreamingChunk (valor predeterminado 800-1200 caracteres; prefiere saltos de párrafo, luego saltos de línea; oraciones al final). Combine fragmentos transmitidos con agents.defaults.blockStreamingCoalesce para reducir el spam de una sola línea (fusión basada en inactividad antes del envío). Los canales que no sean de Telegram requieren un *.blockStreaming: true explícito para habilitar las respuestas en bloque. Los resúmenes detallados de herramientas se emiten al inicio de la herramienta (sin rebote); la interfaz de Control transmite la salida de la herramienta a través de eventos del agente cuando está disponible. Más detalles: Streaming + chunking.

Model refs

Las referencias de modelos en la configuración (por ejemplo agents.defaults.model y agents.defaults.models) se analizan dividiendo en el primer /.

Use provider/model al configurar modelos.
Si el ID del modelo mismo contiene / (estilo OpenRouter), incluya el prefijo del proveedor (ejemplo: openrouter/moonshotai/kimi-k2).
Si omite el proveedor, OpenClaw intenta primero un alias, luego una coincidencia única de proveedor configurado para ese ID de modelo exacto, y solo luego recurre al proveedor predeterminado configurado. Si ese proveedor ya no expone el modelo predeterminado configurado, OpenClaw recurre al primer proveedor/modelo configurado en lugar de mostrar un predeterminado obsoleto de un proveedor eliminado.

Configuración (mínima)

Como mínimo, establezca:

agents.defaults.workspace
channels.whatsapp.allowFrom (muy recomendado)

Siguiente: Chats grupales 🦞