Technical reference

Arquitectura del entorno de ejecución del agente

OpenClaw es propietario del entorno de ejecución de agentes integrado. El código del entorno de ejecución se encuentra en src/agents/, el transporte de modelos/proveedores se encuentra en src/llm/ y los contratos orientados a plugins se exponen mediante los barrels de openclaw/plugin-sdk/*.

Estructura del entorno de ejecución

Ruta	Responsabilidad
`src/agents/embedded-agent-runner/`	Bucle de intentos integrado (`run.ts`, `run/`), selección de modelos y normalización de proveedores (`model.ts`), parámetros de solicitud por proveedor (`extra-params.`), Compaction y conexión de transcripciones y sesiones.
`src/agents/sessions/`	Persistencia de sesiones (`session-manager.ts`), detección de recursos (`package-manager.ts`, `resource-loader.ts`), carga de `extensions` en la sesión, plantillas de prompts, Skills, temas y renderizadores de herramientas basados en TUI (`tools/`).
`packages/agent-core/`	Núcleo de agente reutilizable (`@openclaw/agent-core`): bucle del agente, tipos del arnés, mensajes, auxiliares de Compaction, plantillas de prompts, Skills y contratos de almacenamiento de sesiones.
`src/agents/runtime/`	Fachada de OpenClaw que conecta `@openclaw/agent-core` con el entorno de ejecución de LLM del SDK de plugins y lo reexporta junto con utilidades de proxy locales.
`src/agents/agent-tools*.ts`	Definiciones de herramientas propiedad de OpenClaw, esquemas de parámetros, políticas de herramientas, adaptadores anteriores y posteriores a las llamadas de herramientas, y herramientas de edición del host y del entorno aislado.
`src/agents/agent-hooks/`	Hooks integrados del entorno de ejecución: protección de Compaction, instrucciones de Compaction y poda de contexto.
`src/agents/harness/`	Registro, política de selección y ciclo de vida de los arneses integrados y registrados por plugins.
`src/llm/`	Registro de modelos/proveedores, auxiliares de transporte e implementaciones de flujo específicas del proveedor (`src/llm/providers/`).

Límites

El núcleo llama al entorno de ejecución integrado mediante módulos de OpenClaw y barrels del SDK; ya no queda ningún paquete externo de marcos de agentes. Los plugins utilizan los puntos de entrada documentados de openclaw/plugin-sdk/* y no importan elementos internos de src/**.

@earendil-works/pi-tui sigue siendo una dependencia de terceros: un kit de herramientas de componentes de terminal utilizado por la TUI local y los renderizadores de herramientas de sesión. Su internalización requeriría un esfuerzo de incorporación de dependencias independiente.

Manifiestos

Los paquetes de recursos declaran recursos de OpenClaw en los metadatos de package.json. Las entradas son rutas de archivos o patrones glob relativos a la raíz del paquete:

json

{  "openclaw": {    "extensions": ["extensions/index.ts"],    "skills": ["skills/*.md"],    "prompts": ["prompts/*.md"],    "themes": ["themes/*.json"]  }}

Los tipos de recursos que no figuran en un manifiesto recurren a la detección de los directorios convencionales extensions/, skills/, prompts/ y themes/.

Selección del entorno de ejecución

El identificador del entorno de ejecución integrado es openclaw. El alias heredado pi se normaliza como openclaw; codex-app-server se normaliza como codex.
Los arneses de plugins registran identificadores adicionales de entornos de ejecución (por ejemplo, codex).
La política del entorno de ejecución es una configuración agentRuntime.id con alcance de modelo/proveedor (la entrada del modelo prevalece sobre la del proveedor). Un valor no establecido o default se resuelve como auto.
auto selecciona un arnés de Plugin registrado que admita la ruta efectiva del proveedor; de lo contrario, selecciona el entorno de ejecución integrado de OpenClaw. Un prefijo de proveedor o modelo por sí solo nunca selecciona un arnés.
OpenAI puede seleccionar implícitamente codex solo para una ruta oficial HTTPS exacta de Platform Responses o ChatGPT Responses sin ninguna sobrescritura de solicitud definida. Los adaptadores de Completions, los endpoints personalizados y las rutas con comportamiento de solicitud definido permanecen en openclaw; los endpoints HTTP oficiales sin cifrar se rechazan. Consulte Entorno de ejecución de agentes implícito de OpenAI.

Generaciones del entorno de ejecución de modelos

El inicio del Gateway y la publicación de configuración, plugins o autenticación crean una generación preparada del entorno de ejecución de modelos por cada agente configurado. Cada generación contiene la plantilla de autenticación detectada, el registro de modelos y el catálogo de modelos proyectado como una única instantánea atómica. Las ejecuciones de agentes bifurcan almacenes mutables de autenticación y registro a partir de esa instantánea; las rutas de exploración, estado, Cron, diagnóstico, TUI, PDF e imágenes leen el catálogo publicado en lugar de repetir la detección del sistema de archivos.

Los entornos de ejecución integrados independientes publican la misma estructura de instantánea en su límite de activación. Una generación fallida u obsoleta nunca se sirve junto con una generación parcial más reciente; el propietario del ciclo de vida debe publicar primero un reemplazo completo.

Temas relacionados

Was this useful?