OpenClaw ejecuta trabajo en segundo plano mediante tareas, trabajos programados, compromisos inferidos, hooks de eventos e instrucciones permanentes. Esta página te ayuda a elegir el mecanismo adecuado y a entender cómo encajan entre sí.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.
Guía rápida de decisión
| Caso de uso | Recomendado | Por qué |
|---|---|---|
| Enviar un informe diario exactamente a las 9 a. m. | Tareas programadas (Cron) | Temporización exacta, ejecución aislada |
| Recuérdame en 20 minutos | Tareas programadas (Cron) | Ejecución única con temporización precisa (--at) |
| Ejecutar un análisis profundo semanal | Tareas programadas (Cron) | Tarea independiente, puede usar otro modelo |
| Revisar la bandeja de entrada cada 30 min | Heartbeat | Agrupa con otras comprobaciones, consciente del contexto |
| Supervisar el calendario para próximos eventos | Heartbeat | Ajuste natural para conciencia periódica |
| Hacer seguimiento después de una entrevista mencionada | Compromisos inferidos | Seguimiento similar a memoria, sin solicitud de recordatorio exacto |
| Comprobación de cuidado suave tras contexto del usuario | Compromisos inferidos | Limitado al mismo agente y canal |
| Inspeccionar el estado de un subagente o ejecución ACP | Tareas en segundo plano | El registro de tareas rastrea todo el trabajo desacoplado |
| Auditar qué se ejecutó y cuándo | Tareas en segundo plano | openclaw tasks list y openclaw tasks audit |
| Investigación de varios pasos y luego resumen | Task Flow | Orquestación duradera con seguimiento de revisiones |
| Ejecutar un script al restablecer la sesión | Hooks | Basado en eventos, se dispara en eventos del ciclo de vida |
| Ejecutar código en cada llamada a herramienta | Hooks de Plugin | Los hooks en proceso pueden interceptar llamadas a herramientas |
| Comprobar siempre el cumplimiento antes de responder | Órdenes permanentes | Se inyectan automáticamente en cada sesión |
Tareas programadas (Cron) frente a Heartbeat
| Dimensión | Tareas programadas (Cron) | Heartbeat |
|---|---|---|
| Temporización | Exacta (expresiones cron, ejecución única) | Aproximada (por defecto cada 30 min) |
| Contexto de sesión | Nuevo (aislado) o compartido | Contexto completo de la sesión principal |
| Registros de tareas | Siempre se crean | Nunca se crean |
| Entrega | Canal, webhook o silenciosa | En línea en la sesión principal |
| Ideal para | Informes, recordatorios, trabajos en segundo plano | Revisiones de bandeja de entrada, calendario, notificaciones |
Conceptos principales
Tareas programadas (cron)
Cron es el programador integrado del Gateway para temporización precisa. Persiste trabajos, despierta al agente en el momento adecuado y puede entregar la salida a un canal de chat o endpoint de webhook. Admite recordatorios de ejecución única, expresiones recurrentes y disparadores de webhook entrantes. Consulta Tareas programadas.Tareas
El registro de tareas en segundo plano rastrea todo el trabajo desacoplado: ejecuciones ACP, creación de subagentes, ejecuciones cron aisladas y operaciones de CLI. Las tareas son registros, no programadores. Usaopenclaw tasks list y openclaw tasks audit para inspeccionarlas.
Consulta Tareas en segundo plano.
Compromisos inferidos
Los compromisos son memorias de seguimiento opcionales y de corta duración. OpenClaw los infiere a partir de conversaciones normales, los limita al mismo agente y canal, y entrega las comprobaciones pendientes mediante heartbeat. Los recordatorios exactos solicitados por el usuario siguen perteneciendo a cron. Consulta Compromisos inferidos.Task Flow
Task Flow es el sustrato de orquestación de flujos por encima de las tareas en segundo plano. Gestiona flujos duraderos de varios pasos con modos de sincronización gestionados y reflejados, seguimiento de revisiones yopenclaw tasks flow list|show|cancel para inspección.
Consulta Task Flow.
Órdenes permanentes
Las órdenes permanentes conceden al agente autoridad operativa permanente para programas definidos. Viven en archivos del workspace (normalmenteAGENTS.md) y se inyectan en cada sesión. Combínalas con cron para aplicación basada en tiempo.
Consulta Órdenes permanentes.
Hooks
Los hooks internos son scripts basados en eventos activados por eventos del ciclo de vida del agente (/new, /reset, /stop), compaction de sesión, inicio del gateway y flujo de mensajes. Se descubren automáticamente desde directorios y pueden gestionarse con openclaw hooks. Para interceptación en proceso de llamadas a herramientas, usa hooks de Plugin.
Consulta Hooks.
Heartbeat
Heartbeat es un turno periódico de la sesión principal (por defecto cada 30 minutos). Agrupa varias comprobaciones (bandeja de entrada, calendario, notificaciones) en un único turno del agente con contexto completo de sesión. Los turnos de Heartbeat no crean registros de tareas y no amplían la frescura del restablecimiento diario/por inactividad de la sesión. UsaHEARTBEAT.md para una lista de comprobación pequeña, o un bloque tasks: cuando quieras comprobaciones periódicas solo de vencidos dentro del propio heartbeat. Los archivos de heartbeat vacíos se omiten como empty-heartbeat-file; el modo de tareas solo de vencidos se omite como no-tasks-due. Los heartbeats se aplazan mientras el trabajo cron está activo o en cola, y heartbeat.skipWhenBusy también puede aplazar un agente mientras el subagente con clave de sesión de ese mismo agente o sus líneas anidadas están ocupados.
Consulta Heartbeat.
Cómo funcionan juntos
- Cron gestiona programaciones precisas (informes diarios, revisiones semanales) y recordatorios de ejecución única. Todas las ejecuciones cron crean registros de tareas.
- Heartbeat gestiona la supervisión rutinaria (bandeja de entrada, calendario, notificaciones) en un único turno agrupado cada 30 minutos.
- Hooks reaccionan a eventos específicos (restablecimientos de sesión, compaction, flujo de mensajes) con scripts personalizados. Los hooks de Plugin cubren llamadas a herramientas.
- Órdenes permanentes dan al agente contexto persistente y límites de autoridad.
- Task Flow coordina flujos de varios pasos por encima de tareas individuales.
- Tareas rastrean automáticamente todo el trabajo desacoplado para que puedas inspeccionarlo y auditarlo.
Relacionado
- Tareas programadas — programación precisa y recordatorios de ejecución única
- Compromisos inferidos — comprobaciones de seguimiento similares a memoria
- Tareas en segundo plano — registro de tareas para todo el trabajo desacoplado
- Task Flow — orquestación duradera de flujos de varios pasos
- Hooks — scripts del ciclo de vida basados en eventos
- Hooks de Plugin — hooks en proceso de herramientas, prompts, mensajes y ciclo de vida
- Órdenes permanentes — instrucciones persistentes del agente
- Heartbeat — turnos periódicos de la sesión principal
- Referencia de configuración — todas las claves de configuración