Automazione

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw esegue lavoro in background tramite attività, lavori pianificati, impegni dedotti, hook di eventi e istruzioni permanenti. Questa pagina ti aiuta a scegliere il meccanismo corretto e a capire come si integrano.

​

Guida rapida alla decisione

​

Attività pianificate (Cron) rispetto a Heartbeat

Usa le Attività pianificate (Cron) quando servono tempistiche precise o un’esecuzione isolata. Usa Heartbeat quando il lavoro trae beneficio dal contesto completo della sessione e tempistiche approssimative vanno bene.

​

Concetti principali

​

Attività pianificate (cron)

Cron è lo scheduler integrato del Gateway per tempistiche precise. Persiste i lavori, risveglia l’agente al momento giusto e può consegnare l’output a un canale chat o a un endpoint webhook. Supporta promemoria una tantum, espressioni ricorrenti e trigger webhook in ingresso. Vedi Attività pianificate.

​

Attività

Il registro delle attività in background traccia tutto il lavoro separato: esecuzioni ACP, avvii di sottoagenti, esecuzioni cron isolate e operazioni CLI. Le attività sono record, non scheduler. Usa openclaw tasks list e openclaw tasks audit per ispezionarle. Vedi Attività in background.

​

Impegni dedotti

Gli impegni sono memorie di follow-up facoltative e di breve durata. OpenClaw li deduce dalle conversazioni normali, li limita allo stesso agente e canale e consegna i check-in dovuti tramite heartbeat. I promemoria esatti richiesti dall’utente restano di competenza di cron. Vedi Impegni dedotti.

​

Task Flow

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

​

Ordini permanenti

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

​

Hook

Gli hook interni sono script basati su eventi attivati da eventi del ciclo di vita dell’agente (/new, /reset, /stop), Compaction della sessione, avvio del gateway e flusso dei messaggi. Vengono scoperti automaticamente dalle directory e possono essere gestiti con openclaw hooks. Per l’intercettazione in-process delle chiamate di strumento, usa Hook Plugin. Vedi Hook.

​

Heartbeat

Heartbeat è un turno periodico della sessione principale (predefinito ogni 30 minuti). Raggruppa più controlli (posta, calendario, notifiche) in un unico turno dell’agente con il contesto completo della sessione. I turni Heartbeat non creano record attività e non estendono la freschezza del reset giornaliero/inattivo della sessione. Usa HEARTBEAT.md per una piccola checklist, oppure un blocco tasks: quando vuoi controlli periodici solo se dovuti dentro heartbeat stesso. I file heartbeat vuoti vengono saltati come empty-heartbeat-file; la modalità attività solo se dovute viene saltata come no-tasks-due. Gli Heartbeat vengono rinviati mentre il lavoro cron è attivo o in coda, e heartbeat.skipWhenBusy può anche rinviare un agente mentre il sottoagente con chiave di sessione dello stesso agente o le lane annidate sono occupati. Vedi Heartbeat.

​

Come funzionano insieme

• Cron gestisce pianificazioni precise (report giornalieri, revisioni settimanali) e promemoria una tantum. Tutte le esecuzioni cron creano record attività.
• Heartbeat gestisce il monitoraggio di routine (posta, calendario, notifiche) in un unico turno raggruppato ogni 30 minuti.
• Hook reagiscono a eventi specifici (reset della sessione, Compaction, flusso dei messaggi) con script personalizzati. Gli hook Plugin coprono le chiamate di strumento.
• Ordini permanenti danno all’agente contesto persistente e confini di autorità.
• Task Flow coordina flussi in più passaggi sopra le singole attività.
• Attività traccia automaticamente tutto il lavoro separato, così puoi ispezionarlo e verificarlo.

​

Correlati

• Attività pianificate — pianificazione precisa e promemoria una tantum
• Impegni dedotti — check-in di follow-up simili alla memoria
• Attività in background — registro attività per tutto il lavoro separato
• Task Flow — orchestrazione durevole di flussi in più passaggi
• Hook — script del ciclo di vita basati su eventi
• Hook Plugin — hook in-process di strumenti, prompt, messaggi e ciclo di vita
• Ordini permanenti — istruzioni persistenti per l’agente
• Heartbeat — turni periodici della sessione principale
• Riferimento configurazione — tutte le chiavi di configurazione