---
summary: Come OpenClaw esegue il runtime agente integrato, i provider, le sessioni, gli strumenti e le estensioni.
title: Architettura del runtime degli agenti
x-i18n:
    generated_at: "2026-06-27T17:08:47Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: cd0ca61b10a4f7029590da8566b22cc44cf801af162e5f2c00c9561fe46e39e3
    source_path: agent-runtime-architecture.md
    workflow: 16
---

OpenClaw possiede direttamente il runtime dell'agente integrato. Il codice del runtime si trova in `src/agents/`, gli helper per modelli/provider si trovano in `src/llm/` e i contratti rivolti ai plugin sono esposti tramite i barrel `openclaw/plugin-sdk/*`.

## Layout del runtime

- `src/agents/embedded-agent-runner/`: loop dei tentativi dell'agente integrato, adattatori di stream dei provider, Compaction, selezione del modello e cablaggio della sessione.
- `src/agents/sessions/`: persistenza delle sessioni, caricamento delle estensioni, rilevamento delle risorse, Skills, prompt, temi e renderer degli strumenti basati su TUI.
- `packages/agent-core/`: core agente riutilizzabile, tipi di harness di livello inferiore, messaggi, helper di Compaction, template di prompt e contratti di strumenti/sessione.
- `src/agents/runtime/`: facade OpenClaw per `@openclaw/agent-core` più utilità proxy locali.
- `src/agents/agent-tools*.ts`: definizioni degli strumenti di proprietà di OpenClaw, schemi, policy, adattatori di hook prima/dopo e supporto alle modifiche sull'host.
- `src/agents/agent-hooks/`: hook del runtime integrati come salvaguardie di Compaction e potatura del contesto.
- `src/llm/`: registro di modelli/provider, helper di trasporto e implementazioni di stream specifiche dei provider.

## Confini

Il codice core chiama il runtime integrato tramite moduli OpenClaw e barrel SDK, non tramite vecchi pacchetti agente esterni. I Plugin usano gli entrypoint documentati `openclaw/plugin-sdk/*` e non importano elementi interni di `src/**`.

`@earendil-works/pi-tui` rimane una dipendenza TUI di terze parti. È usata come toolkit di componenti terminale dal TUI locale e dai renderer di sessione; internalizzarla sarebbe un intervento separato di vendoring.

## Manifest

I pacchetti di risorse dichiarano le risorse OpenClaw nei metadati del pacchetto:

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

Il package manager rileva anche le directory convenzionali `extensions/`, `skills/`, `prompts/` e `themes/`.

## Selezione del runtime

L'id del runtime integrato predefinito è `openclaw`. Gli harness dei Plugin possono registrare ulteriori id di runtime. `auto` seleziona un harness Plugin compatibile quando ne esiste uno e altrimenti usa il runtime OpenClaw integrato.

## Correlati

- [Workflow del runtime agente OpenClaw](/it/openclaw-agent-runtime)
- [Runtime agente](/it/concepts/agent-runtimes)