Automation

Automatización

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í.

Guía rápida de decisión

flowchart TD
    START([What do you need?]) --> Q1{Schedule work?}
    START --> Q2{Track detached work?}
    START --> Q3{Orchestrate multi-step flows?}
    START --> Q4{React to lifecycle events?}
    START --> Q5{Give the agent persistent instructions?}
    START --> Q6{Remember a natural follow-up?}

    Q1 -->|Yes| Q1a{Exact timing or flexible?}
    Q1a -->|Exact| CRON["Scheduled Tasks (Cron)"]
    Q1a -->|Flexible| HEARTBEAT[Heartbeat]

    Q2 -->|Yes| TASKS[Background Tasks]
    Q3 -->|Yes| FLOW[Task Flow]
    Q4 -->|Yes| HOOKS[Hooks]
    Q5 -->|Yes| SO[Standing Orders]
    Q6 -->|Yes| COMMITMENTS[Inferred Commitments]

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

Usa Tareas programadas (Cron) cuando necesites temporización precisa o ejecución aislada. Usa Heartbeat cuando el trabajo se beneficie del contexto completo de la sesión y una temporización aproximada sea suficiente.

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. Usa openclaw 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 y openclaw 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 (normalmente AGENTS.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. Usa HEARTBEAT.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

Was this useful?