Technical reference

Arquitetura do runtime do agente

OpenClaw é responsável pelo runtime de agente integrado. O código do runtime fica em src/agents/, o transporte de modelos/provedores fica em src/llm/, e os contratos voltados a plugins são expostos por meio dos barrels openclaw/plugin-sdk/*.

Estrutura do runtime

Caminho	Responsável por
`src/agents/embedded-agent-runner/`	Loop de tentativas integrado (`run.ts`, `run/`), seleção de modelo e normalização de provedor (`model.ts`), parâmetros de solicitação por provedor (`extra-params.`), Compaction e integração de transcrição e sessão.
`src/agents/sessions/`	Persistência de sessões (`session-manager.ts`), descoberta de recursos (`package-manager.ts`, `resource-loader.ts`), carregamento de `extensions` durante a sessão, modelos de prompt, Skills, temas e renderizadores de ferramentas baseados em TUI (`tools/`).
`packages/agent-core/`	Núcleo de agente reutilizável (`@openclaw/agent-core`): loop do agente, tipos de harness, mensagens, auxiliares de Compaction, modelos de prompt, Skills e contratos de armazenamento de sessões.
`src/agents/runtime/`	Fachada do OpenClaw que conecta `@openclaw/agent-core` ao runtime de LLM do SDK de plugins e o reexporta junto com utilitários locais de proxy.
`src/agents/agent-tools*.ts`	Definições de ferramentas mantidas pelo OpenClaw, esquemas de parâmetros, política de ferramentas, adaptadores anteriores e posteriores às chamadas de ferramentas e ferramentas de edição do host/sandbox.
`src/agents/agent-hooks/`	Hooks integrados do runtime: proteção de Compaction, instruções de Compaction e poda de contexto.
`src/agents/harness/`	Registro, política de seleção e ciclo de vida de harnesses integrados e registrados por plugins.
`src/llm/`	Registro de modelos/provedores, auxiliares de transporte e implementações de streaming específicas de provedores (`src/llm/providers/`).

Limites

O núcleo chama o runtime integrado por meio dos módulos do OpenClaw e dos barrels do SDK; não restam pacotes externos de frameworks de agentes. Os plugins usam pontos de entrada documentados de openclaw/plugin-sdk/* e não importam componentes internos de src/**.

@earendil-works/pi-tui continua sendo uma dependência de terceiros: um kit de ferramentas de componentes para terminal usado pela TUI local e pelos renderizadores de ferramentas de sessão. Internalizá-lo exigiria um esforço separado de incorporação do código do fornecedor.

Manifestos

Os pacotes de recursos declaram recursos do OpenClaw nos metadados de package.json. As entradas são caminhos de arquivos ou globs relativos à raiz do pacote:

json

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

Os tipos de recursos não listados em um manifesto recorrem à descoberta dos diretórios convencionais extensions/, skills/, prompts/ e themes/.

Seleção do runtime

O id do runtime integrado é openclaw. O alias legado pi é normalizado para openclaw; codex-app-server é normalizado para codex.
Os harnesses de plugins registram ids de runtime adicionais (por exemplo, codex).
A política de runtime é a configuração agentRuntime.id no escopo do modelo/provedor (a entrada do modelo tem precedência sobre a entrada do provedor). Quando não definido ou definido como default, o valor é resolvido como auto.
auto seleciona um harness de plugin registrado que seja compatível com a rota efetiva do provedor; caso contrário, seleciona o runtime integrado do OpenClaw. Um prefixo de provedor ou modelo, por si só, nunca seleciona um harness.
A OpenAI pode selecionar codex implicitamente somente para uma rota oficial HTTPS exata de Platform Responses ou ChatGPT Responses, sem substituição de solicitação definida pelo autor. Adaptadores de Completions, endpoints personalizados e rotas com comportamento de solicitação definido pelo autor permanecem em openclaw; endpoints HTTP oficiais sem criptografia são rejeitados. Consulte runtime de agente implícito da OpenAI.

Relacionado

Was this useful?