Technical reference

Arquitectura del entorno de ejecución del agente

OpenClaw es propietario del entorno de ejecución de agente 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 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` durante la sesión, plantillas de prompts, Skills, temas y renderizadores de herramientas respaldados por la TUI (`tools/`).
`packages/agent-core/`	Núcleo de agente reutilizable (`@openclaw/agent-core`): bucle del agente, tipos del arnés, mensajes, utilidades 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 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/sandbox.
`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, utilidades de transporte e implementaciones de flujos específicas de cada 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; no queda ningún paquete externo de marcos de agentes. Los plugins utilizan 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. Internalizarlo requeriría un esfuerzo independiente de incorporación del código de terceros.

Manifiestos

Los paquetes de recursos declaran recursos de OpenClaw en los metadatos de package.json. Las entradas son rutas de archivo 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 la configuración agentRuntime.id con ámbito de modelo/proveedor (la entrada del modelo prevalece sobre la del proveedor). Si no se establece o es default, se resuelve como auto.
auto selecciona un arnés de plugin registrado que sea compatible con 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 codex implícitamente solo para una ruta oficial HTTPS exacta de Platform Responses o ChatGPT Responses sin una sobrescritura de solicitud definida por el autor. Los adaptadores de Completions, los endpoints personalizados y las rutas con comportamiento de solicitud definido por el autor permanecen en openclaw; se rechazan los endpoints HTTP oficiales sin cifrar. Consulte Entorno de ejecución de agente implícito de OpenAI.

Temas relacionados

Was this useful?