Sub-agent e agenti multipli in OpenClaw

OpenClaw ha due risposte alla domanda di avere più di un agente, e la documentazione le tiene separate. I sub-agent sono esecuzioni in background avviate da un’esecuzione esistente, ognuna nella propria sessione, che annunciano il risultato a chi l’ha chiesto e vengono tracciate come attività in background; gli agenti multipli sono agenti configurati separatamente, con i propri spazi di lavoro e il proprio instradamento. Ecco cos’è un sub-agent e quanto costa, fin dove arriva l’annidamento e come tornano i risultati, gli strumenti che un figlio non può mai avere e dove vive l’altro tipo di molteplicità.

I sub-agent sono esecuzioni di agente in background avviate da un’esecuzione di agente esistente.

Cos’è un sub-agent

• Una propria chiave di sessione sotto l’agente padre, un annuncio di ritorno al richiedente per impostazione predefinita, per la revisione, e un record di attività in background per ogni esecuzione; gli obiettivi sono la ricerca in parallelo e il lavoro lento con gli strumenti senza bloccare l’esecuzione principale, l’isolamento per sessione e con sandbox opzionale, e una superficie di strumenti difficile da usare male.
• Un proprio contesto e un proprio consumo di token: la nota sui costi della documentazione dice di impostare un modello più economico per i sub-agent e tenere l’agente principale su quello migliore, e di fare il fork della trascrizione del richiedente in un figlio solo quando ne ha davvero bisogno.
• Un’esecuzione finisce, una sessione no: un’esecuzione terminata è di sola lettura nella Control UI, con un modo per tornare al padre, e una sessione visibile persistente viene creata solo quando l’utente ne chiede una, non perché un’attività è stata lunga o ha prodotto un report.

Annidamento e ritorno dei risultati

Per impostazione predefinita i sub-agent possono delegare ricorsivamente fino alla profondità cinque, con parametri per la profondità di avvio, da uno a cinque, per i figli attivi per agente, cinque per impostazione predefinita e fino a venti, un limite globale di otto per la corsia di concorrenza, un timeout di esecuzione predefinito e un timeout di annuncio. L’agente principale sta alla profondità zero, gli orchestratori sotto il limite possono avviare figli e una foglia al limite no. I risultati risalgono un livello alla volta: un discendente annuncia al proprio padre, il padre sintetizza i risultati dei figli prima di annunciare verso l’alto, e l’agente principale consegna all’utente. La documentazione dice agli agenti di attendere gli eventi di completamento invece di fare polling, e di rispondere a un completamento tardivo con il token silenzioso di non risposta.

Gli strumenti che un figlio non ottiene mai

• Sempre persi, a qualsiasi profondità: lo strumento gateway, l’elenco degli agenti, lo stato della sessione, le schede di avanzamento, cron, message, l’invio alle sessioni e gli strumenti di conversazione. È un divieto rigido derivato a ogni turno dall’involucro di sessione del sub-agent, e le normali allowlist non possono scavalcarlo.
• Al limite di profondità si perdono anche gli strumenti dei sub-agent, l’elenco delle sessioni, la cronologia delle sessioni e l’avvio di nuovi figli, quindi l’unico modo in cui una foglia può parlare è la catena di annuncio.
• La policy degli strumenti dei sub-agent può negare di più o impostare un filtro finale di sola autorizzazione, ma quel filtro non può restituire uno strumento che il profilo degli strumenti ha rimosso; l’esempio della documentazione è il browser che manca nel profilo coding.

La guida alle automazioni di OpenClaw copre le esecuzioni pianificate che spesso li avviano, e l’articolo sulla sandbox di OpenClaw spiega l’isolamento che un figlio può ereditare.

Agenti multipli e sub-agent a confronto

Più agenti configurati vivono sotto le voci per agente della configurazione, ognuno in grado di sovrascrivere i valori predefiniti dove lo schema lo consente, con canali e stanze instradati verso di loro; le pagine su Discord e Matrix menzionano entrambe l’associazione di server e stanze agli agenti. I sub-agent sono figli temporanei di una singola esecuzione, avviati da uno strumento invece che dichiarati in un file. Il file di configurazione di OpenClaw spiega i due contenitori in cui si trovano le voci.

Su Diali

Su Diali ogni assistente è un’istanza isolata a sé, quindi più agenti significa più assistenti, ognuno con i propri canali e il proprio spazio di lavoro, e i sub-agent restano dentro l’esecuzione di un solo assistente con le stesse regole di profondità e di strumenti. OpenClaw ospitato su Diali è l’assistente e la pagina dei prezzi di Diali mostra come vengono contati gli assistenti.

• Un figlio gira nella propria sessione e annuncia verso l’alto.
• Profondità cinque per impostazione predefinita; una foglia non può avviare figli.
• Cron, message, gateway e gli strumenti di sessione non spettano mai a un figlio.