​

Automazione e task

OpenClaw esegue il lavoro in background tramite task, processi pianificati, hook di eventi e istruzioni permanenti. Questa pagina ti aiuta a scegliere il meccanismo giusto e a capire come si integrano tra loro.

​

Guida rapida alle decisioni

​

Task pianificati (Cron) vs Heartbeat

Usa i Task pianificati (Cron) quando hai bisogno di una tempistica precisa o di un’esecuzione isolata. Usa Heartbeat quando il lavoro beneficia del contesto completo della sessione e una tempistica approssimativa va bene.

​

Concetti fondamentali

​

Task pianificati (cron)

Cron è lo scheduler integrato del Gateway per una tempistica precisa. Mantiene i processi, riattiva l’agente al momento giusto e può consegnare l’output a un canale chat o a un endpoint webhook. Supporta promemoria monouso, espressioni ricorrenti e trigger webhook in ingresso. Vedi Task pianificati.

​

Task

Il registro dei task in background tiene traccia di tutto il lavoro scollegato: esecuzioni ACP, avvii di subagenti, esecuzioni cron isolate e operazioni CLI. I task sono record, non scheduler. Usa openclaw tasks list e openclaw tasks audit per ispezionarli. Vedi Task in background.

​

Task Flow

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

​

Ordini permanenti

Gli ordini permanenti concedono all’agente un’autorità operativa permanente per programmi definiti. Risiedono nei file dell’area di lavoro (tipicamente AGENTS.md) e vengono iniettati in ogni sessione. Combinali con cron per l’applicazione basata sul tempo. Vedi Ordini permanenti.

​

Hook

Gli hook sono script basati su eventi attivati da eventi del ciclo di vita dell’agente (/new, /reset, /stop), compattazione della sessione, avvio del gateway, flusso dei messaggi e chiamate ai tool. Gli hook vengono rilevati automaticamente dalle directory e possono essere gestiti con openclaw hooks. Vedi Hook.

​

Heartbeat

Heartbeat è un turno periodico della sessione principale (predefinito ogni 30 minuti). Raggruppa più controlli (posta in arrivo, calendario, notifiche) in un unico turno dell’agente con il contesto completo della sessione. I turni Heartbeat non creano record di task. Usa HEARTBEAT.md per una piccola checklist, oppure un blocco tasks: quando vuoi controlli periodici solo-se-dovuti all’interno di heartbeat stesso. I file heartbeat vuoti vengono saltati come empty-heartbeat-file; la modalità task solo-se-dovuti viene saltata come no-tasks-due. Vedi Heartbeat.

​

Come lavorano insieme

• Cron gestisce pianificazioni precise (report giornalieri, revisioni settimanali) e promemoria monouso. Tutte le esecuzioni cron creano record di task.
• Heartbeat gestisce il monitoraggio di routine (posta in arrivo, calendario, notifiche) in un unico turno raggruppato ogni 30 minuti.
• Hook reagiscono a eventi specifici (chiamate ai tool, reset della sessione, compattazione) con script personalizzati.
• Ordini permanenti forniscono all’agente contesto persistente e limiti di autorità.
• Task Flow coordina flussi in più passaggi sopra i singoli task.
• Task tengono automaticamente traccia di tutto il lavoro scollegato, così puoi ispezionarlo e verificarlo.

​

Correlati

• Task pianificati — pianificazione precisa e promemoria monouso
• Task in background — registro dei task per tutto il lavoro scollegato
• Task Flow — orchestrazione duratura di flussi in più passaggi
• Hook — script del ciclo di vita basati su eventi
• Ordini permanenti — istruzioni persistenti per l’agente
• Heartbeat — turni periodici della sessione principale
• Riferimento configurazione — tutte le chiavi di configurazione