Skip to main content
OpenClaw ejecuta trabajo en segundo plano mediante tareas, trabajos programados, hooks de eventos e instrucciones permanentes. Use esta página para elegir el mecanismo adecuado.

​
Guía rápida de decisión

​
Tareas programadas (Cron) frente a Heartbeat

Use Tareas programadas (Cron) cuando necesite un horario preciso o una ejecución aislada. Use Heartbeat cuando el trabajo se beneficie del contexto completo de la sesión y baste con un horario aproximado.

​
Conceptos principales

​
Tareas programadas (cron)

Cron es el planificador integrado del Gateway para horarios precisos. Conserva los trabajos, activa el agente en el momento adecuado y puede entregar la salida a un canal de chat o a un endpoint de webhook. Admite recordatorios de ejecución única, expresiones recurrentes y activadores de webhook entrantes. Consulte Tareas programadas.

​
Tareas

El registro de tareas en segundo plano rastrea todo el trabajo desvinculado: ejecuciones de ACP, creación de subagentes, ejecuciones cron aisladas y operaciones de la CLI. Las tareas son registros, no planificadores. Use openclaw tasks list y openclaw tasks audit para inspeccionarlas. Consulte Tareas en segundo plano.

​
Flujo de tareas

El Flujo de tareas es la base de orquestación de flujos situada sobre las tareas en segundo plano. Gestiona flujos duraderos de varios pasos con modos de sincronización gestionada y reflejada, seguimiento de revisiones y openclaw tasks flow list|show|cancel para su inspección. Consulte Flujo de tareas.

​
Órdenes permanentes

Las órdenes permanentes conceden al agente autoridad operativa permanente para programas definidos. Se encuentran en archivos del espacio de trabajo (normalmente AGENTS.md) y se insertan en cada sesión. Combínelas con cron para aplicar requisitos basados en el tiempo. Consulte Órdenes permanentes.

​
Hooks

Los hooks internos son scripts basados en eventos que se activan mediante eventos del ciclo de vida del agente (/new, /reset, /stop), la Compaction de la sesión, el inicio del Gateway y el flujo de mensajes. Se detectan en directorios de hooks y se gestionan con openclaw hooks. Para interceptar llamadas a herramientas en proceso, use Hooks de Plugin. Consulte Hooks.

​
Heartbeat

Heartbeat es un turno periódico de la sesión principal (de forma predeterminada, cada 30 minutos). Agrupa la supervisión basada en listas de comprobación (bandeja de entrada, calendario y notificaciones) en un solo turno del agente con el contexto completo de la sesión. Los turnos de Heartbeat no crean registros de tareas ni prolongan la vigencia para el restablecimiento diario o por inactividad de la sesión. El espacio temporal de Heartbeat es un contexto pequeño del prompt; programe el trabajo recurrente como trabajos cron. Si el espacio temporal de Heartbeat está vacío, se omite como empty-heartbeat-file. Los Heartbeats se aplazan mientras haya trabajo cron activo o en cola, y heartbeat.skipWhenBusy también puede aplazar un agente mientras estén ocupados los subagentes vinculados a la clave de sesión de ese mismo agente o sus carriles anidados. Consulte Heartbeat.

​
Cómo funcionan en conjunto

  • Cron gestiona horarios precisos (informes diarios, revisiones semanales) y recordatorios de ejecución única. Todas las ejecuciones cron crean registros de tareas.
  • Heartbeat gestiona una lista de supervisión agrupada cada 30 minutos; cron se encarga de las comprobaciones que necesitan frecuencias independientes.
  • Los hooks reaccionan a eventos específicos (restablecimientos de sesión, Compaction y flujo de mensajes) mediante scripts personalizados. Los hooks de Plugin abarcan las llamadas a herramientas.
  • Las órdenes permanentes proporcionan al agente contexto persistente y límites de autoridad.
  • El Flujo de tareas coordina flujos de varios pasos por encima de las tareas individuales.
  • Las tareas rastrean automáticamente todo el trabajo desvinculado para que pueda inspeccionarlo y auditarlo.

​
Contenido relacionado