Automazione

OpenClaw esegue attività in background tramite task, processi pianificati, impegni dedotti, hook di eventi e istruzioni permanenti. Usa questa pagina per scegliere il meccanismo corretto.

​

Guida rapida alla scelta

​

Task pianificati (Cron) e Heartbeat a confronto

Usa i Task pianificati (Cron) quando hai bisogno di una tempistica precisa o di un’esecuzione isolata. Usa Heartbeat quando l’attività trae vantaggio dal contesto completo della sessione e una tempistica approssimativa è accettabile.

​

Concetti fondamentali

​

Task pianificati (cron)

Cron è il pianificatore integrato del Gateway per una tempistica precisa. Rende persistenti i processi, attiva l’agente al momento giusto e può consegnare l’output a un canale di chat o a un endpoint webhook. Supporta promemoria con esecuzione singola, espressioni ricorrenti e attivazioni tramite webhook in ingresso. Vedi Task pianificati.

​

Task

Il registro dei task in background tiene traccia di tutte le attività separate: esecuzioni ACP, avvii di subagenti, esecuzioni cron isolate e operazioni CLI. I task sono registrazioni, non pianificatori. Usa openclaw tasks list e openclaw tasks audit per esaminarli. Vedi Task in background.

​

Impegni dedotti

Gli impegni sono ricordi di follow-up facoltativi e di breve durata. OpenClaw li deduce dalle normali conversazioni, li limita allo stesso agente e canale e consegna tramite Heartbeat i controlli giunti a scadenza. I promemoria esatti richiesti dall’utente restano di competenza di Cron. Vedi Impegni dedotti.

​

Task Flow

Task Flow è il livello di orchestrazione dei flussi sopra i task in background. Gestisce flussi durevoli in più passaggi con modalità di sincronizzazione gestita e speculare, tracciamento delle revisioni e openclaw tasks flow list|show|cancel per l’ispezione. Vedi Task Flow.

​

Ordini permanenti

Gli ordini permanenti conferiscono all’agente un’autorità operativa permanente per programmi definiti. Risiedono nei file dell’area di lavoro, in genere AGENTS.md, e vengono inseriti in ogni sessione. Combinali con Cron per l’applicazione basata sul tempo. Vedi Ordini permanenti.

​

Hook

Gli hook interni sono script basati sugli eventi, attivati dagli eventi del ciclo di vita dell’agente (/new, /reset, /stop), dalla Compaction della sessione, dall’avvio del Gateway e dal flusso dei messaggi. Vengono individuati nelle directory degli hook e gestiti con openclaw hooks. Per intercettare nello stesso processo le chiamate agli strumenti, usa gli hook dei Plugin. Vedi Hook.

​

Heartbeat

Heartbeat è un turno periodico della sessione principale, per impostazione predefinita ogni 30 minuti. Raggruppa più controlli, come posta, calendario e notifiche, in un singolo turno dell’agente con il contesto completo della sessione. I turni Heartbeat non creano registrazioni dei task e non prolungano la validità per il ripristino giornaliero o per inattività della sessione. Usa HEARTBEAT.md per un breve elenco di controllo oppure un blocco tasks: quando vuoi eseguire all’interno di Heartbeat solo i controlli periodici giunti a scadenza. I file Heartbeat vuoti vengono ignorati con empty-heartbeat-file; la modalità task solo a scadenza viene ignorata con no-tasks-due. Gli Heartbeat vengono rinviati mentre sono attive o in coda attività Cron e heartbeat.skipWhenBusy può inoltre rinviare un agente mentre sono occupate le corsie del subagente associate alla sessione dello stesso agente o quelle nidificate. Vedi Heartbeat.

​

Come interagiscono

• Cron gestisce le pianificazioni precise, come rapporti giornalieri e revisioni settimanali, e i promemoria con esecuzione singola. Tutte le esecuzioni Cron creano registrazioni dei task.
• Heartbeat gestisce il monitoraggio di routine, come posta, calendario e notifiche, in un singolo turno raggruppato ogni 30 minuti.
• Gli hook reagiscono a eventi specifici, come ripristini delle sessioni, Compaction e flusso dei messaggi, mediante script personalizzati. Gli hook dei Plugin gestiscono le chiamate agli strumenti.
• Gli ordini permanenti forniscono all’agente un contesto persistente e limiti di autorità.
• Task Flow coordina i flussi in più passaggi sopra i singoli task.
• I task tengono automaticamente traccia di tutte le attività separate, consentendoti di esaminarle e verificarle.

​

Contenuti correlati

• Task pianificati — pianificazione precisa e promemoria con esecuzione singola
• Impegni dedotti — controlli di follow-up simili a ricordi
• Task in background — registro dei task per tutte le attività separate
• Task Flow — orchestrazione durevole di flussi in più passaggi
• Hook — script del ciclo di vita basati sugli eventi
• Hook dei Plugin — hook nello stesso processo per strumenti, prompt, messaggi e ciclo di vita
• Ordini permanenti — istruzioni persistenti per l’agente
• Heartbeat — turni periodici della sessione principale
• Riferimento della configurazione — tutte le chiavi di configurazione