OpenClaw come agente IA

OpenClaw viene chiamato agente IA per ciò che succede tra un messaggio e una risposta. La documentazione lo descrive come un’esecuzione serializzata per sessione: ricezione, assemblaggio del contesto, inferenza del modello, esecuzione degli strumenti, streaming e persistenza, dove la fase degli strumenti è la parte che un chatbot non ha. Intorno al ciclo ci sono un Gateway che possiede ogni superficie di messaggistica, nodi che prestano dispositivi, sotto-agenti che girano in background e pianificazioni che avviano esecuzioni da sole. Ecco il ciclo come lo descrivono le pagine sull’architettura, ciò che viene assemblato prima che il modello parli, i pezzi che gli stanno intorno e gli hook che ti permettono di cambiarne il comportamento.

Il ciclo dell’agente è l’esecuzione serializzata per sessione che trasforma un messaggio in azioni e in una risposta: ricezione, assemblaggio del contesto, inferenza del modello, esecuzione degli strumenti, streaming, persistenza.

Il ciclo

• Una richiesta all’agente convalida i suoi parametri, risolve la sessione, rende persistenti i metadati della sessione e restituisce subito un id di esecuzione; una chiamata di attesa separata resta bloccata finché il ciclo di vita dell’esecuzione non termina.
• L’esecuzione risolve il modello e i suoi valori predefiniti di ragionamento, carica lo snapshot delle skill, costruisce la sessione, si iscrive agli eventi del runtime, trasmette in streaming i delta dell’assistente e degli strumenti e applica il timeout dell’esecuzione.
• Le esecuzioni sono serializzate per chiave di sessione, e facoltativamente attraverso una corsia globale, quindi non possono verificarsi race condition tra strumenti e sessioni; un claim di scrittura durevole fa da barriera a ogni scrittura della trascrizione, e un’esecuzione superata non può salvare dati obsoleti.

Cosa viene assemblato prima che il modello parli

Lo spazio di lavoro viene risolto e creato, e un’esecuzione in sandbox può essere reindirizzata a una radice della sandbox. Le skill vengono caricate, o riprese da uno snapshot, e iniettate nell’ambiente e nel prompt. I file di contesto di bootstrap finiscono nel prompt di sistema, costruito a partire dal prompt di base di OpenClaw, dal prompt delle skill, dal contesto di bootstrap e dagli override per esecuzione, applicando i limiti del modello e la riserva di compattazione. I canali di messaggistica scelgono una modalità di coda che alimenta la corsia della sessione, ed è per questo che un secondo messaggio durante un’esecuzione orienta o segue invece di entrare in collisione.

Intorno al ciclo

• Il Gateway: un unico processo di lunga durata che possiede tutte le superfici di messaggistica ed espone un’API WebSocket tipizzata, con l’app macOS, la CLI, l’interfaccia web e le automazioni che si connettono come client.
• I nodi: host macOS, iOS, Android e headless si connettono attraverso lo stesso WebSocket con il ruolo di nodo ed espongono comandi come fotocamera, schermo e posizione; l’abbinamento è basato sul dispositivo.
• Sotto-agenti e pianificazioni: le esecuzioni in background avviate da un’esecuzione, e le esecuzioni cron o heartbeat, passano tutte dallo stesso ciclo e dalla stessa policy.

La guida al Gateway di OpenClaw descrive il processo che possiede i canali, l’articolo sui nodi di OpenClaw e sulle mani remote mostra cosa presta un dispositivo abbinato e la guida ai sotto-agenti di OpenClaw spiega le esecuzioni in background.

Gli hook e il confine

Nel processo convivono due sistemi di hook: script interni sugli eventi di comando e di ciclo di vita, e hook tipizzati dei plugin dentro il ciclo, prima che il modello venga risolto, prima che il prompt venga costruito, prima della risposta, dopo l’esecuzione, attorno alle chiamate agli strumenti e, come osservatori, attorno alla compattazione. I webhook sono un’altra cosa: accettano richieste esterne che avviano del lavoro invece di iscriversi agli eventi del ciclo. Il confine è lo stesso che tracciano le pagine sulla sicurezza: la fase degli strumenti è ciò che lo rende un agente, e la policy degli strumenti, le skill di OpenClaw che descrivono invece di eseguire e le indicazioni contro la prompt injection sono ciò che impedisce a un agente che legge il web aperto di esserne manovrato.

Su Diali

Su Diali il ciclo è lo stesso codice descritto dalla documentazione; quello che cambia è chi gestisce il Gateway che lo circonda e chi è sveglio quando un’esecuzione pianificata fallisce. La guida che spiega cos’è OpenClaw è l’introduzione in parole semplici, e OpenClaw ospitato su Diali è l’assistente.

• Ricezione, contesto, inferenza, strumenti, streaming, persistenza, una sessione alla volta.
• Gateway, nodi, sotto-agenti e pianificazioni alimentano tutti lo stesso ciclo.
• Gli hook cambiano il ciclo; la policy e la sandbox lo delimitano.