Technical reference

Architettura del runtime dell'agente

OpenClaw gestisce il runtime dell'agente integrato. Il codice del runtime si trova in src/agents/, il trasporto per modelli/provider si trova in src/llm/ e i contratti destinati ai plugin sono esposti tramite i barrel openclaw/plugin-sdk/*.

Struttura del runtime

Percorso	Responsabilità
`src/agents/embedded-agent-runner/`	Ciclo di tentativi integrato (`run.ts`, `run/`), selezione del modello e normalizzazione del provider (`model.ts`), parametri delle richieste per ciascun provider (`extra-params.`), Compaction, collegamento di trascrizioni e sessioni.
`src/agents/sessions/`	Persistenza delle sessioni (`session-manager.ts`), individuazione delle risorse (`package-manager.ts`, `resource-loader.ts`), caricamento di `extensions` nella sessione, modelli di prompt, Skills, temi e renderer degli strumenti basati sulla TUI (`tools/`).
`packages/agent-core/`	Core riutilizzabile dell'agente (`@openclaw/agent-core`): ciclo dell'agente, tipi dell'harness, messaggi, helper per la Compaction, modelli di prompt, Skills e contratti di archiviazione delle sessioni.
`src/agents/runtime/`	Facade OpenClaw che collega `@openclaw/agent-core` al runtime LLM dell'SDK dei plugin e lo riesporta insieme alle utilità proxy locali.
`src/agents/agent-tools*.ts`	Definizioni degli strumenti gestite da OpenClaw, schemi dei parametri, criteri degli strumenti, adattatori precedenti/successivi alle chiamate degli strumenti e strumenti di modifica dell'host/sandbox.
`src/agents/agent-hooks/`	Hook del runtime integrato: protezione della Compaction, istruzioni per la Compaction, eliminazione selettiva del contesto.
`src/agents/harness/`	Registro degli harness, criteri di selezione e ciclo di vita degli harness integrati e registrati dai plugin.
`src/llm/`	Registro di modelli/provider, helper di trasporto e implementazioni dei flussi specifiche per provider (`src/llm/providers/`).

Confini

Il core chiama il runtime integrato tramite i moduli OpenClaw e i barrel dell'SDK; non rimane alcun pacchetto di framework esterno per agenti. I plugin utilizzano gli entry point openclaw/plugin-sdk/* documentati e non importano componenti interni di src/**.

@earendil-works/pi-tui rimane una dipendenza di terze parti: un toolkit di componenti per terminale utilizzato dalla TUI locale e dai renderer degli strumenti di sessione. La sua internalizzazione richiederebbe un'attività distinta di incorporamento del codice di terze parti.

Manifest

I pacchetti di risorse dichiarano le risorse OpenClaw nei metadati package.json. Le voci sono percorsi di file o glob relativi alla radice del pacchetto:

json

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

Per i tipi di risorse non elencati in un manifest, viene usata come fallback l'individuazione delle directory convenzionali extensions/, skills/, prompts/ e themes/.

Selezione del runtime

L'ID del runtime integrato è openclaw. L'alias legacy pi viene normalizzato in openclaw; codex-app-server viene normalizzato in codex.
Gli harness dei plugin registrano ID di runtime aggiuntivi (ad esempio codex).
I criteri del runtime sono definiti dalla configurazione agentRuntime.id con ambito modello/provider (la voce del modello ha la precedenza su quella del provider). Un valore non impostato o default viene risolto in auto.
auto seleziona un harness di plugin registrato che supporta la route effettiva del provider; in caso contrario, seleziona il runtime OpenClaw integrato. Il solo prefisso di un provider o modello non seleziona mai un harness.
OpenAI può selezionare implicitamente codex soltanto per una route HTTPS ufficiale e corrispondente esattamente a Platform Responses o ChatGPT Responses, senza alcuna sostituzione della richiesta definita dall'utente. Gli adattatori Completions, gli endpoint personalizzati e le route con comportamento della richiesta definito dall'utente rimangono su openclaw; gli endpoint HTTP ufficiali in testo non cifrato vengono rifiutati. Consultare runtime implicito dell'agente OpenAI.

Argomenti correlati

Was this useful?