Tareas programadas

Cron es el planificador integrado del Gateway. Persiste los trabajos, despierta al agente en el momento adecuado y puede devolver el resultado a un canal de chat o a un endpoint de webhook.

Inicio rápido

1. Añadir un recordatorio de un solo disparo

   openclaw cron add \
     --name "Reminder" \
     --at "2026-02-01T16:00:00Z" \
     --session main \
     --system-event "Reminder: check the cron docs draft" \
     --wake now \
     --delete-after-run

2. Verifica tus trabajos

   openclaw cron list
   openclaw cron get

   openclaw cron show

3. Ver historial de ejecuciones

   openclaw cron runs --id

Cómo funciona cron

• Cron se ejecuta dentro del proceso del Gateway (no dentro del modelo).
• Las definiciones de trabajos persisten en ~/.openclaw/cron/jobs.json por lo que los reinicios no pierden las programaciones.
• El estado de ejecución en tiempo de ejecución persiste junto a él en ~/.openclaw/cron/jobs-state.json. Si rastrea las definiciones de cron en git, rastree jobs.json y agregue jobs-state.json a gitignore.
• Después de la división, las versiones anteriores de OpenClaw pueden leer jobs.json pero pueden tratar los trabajos como nuevos porque los campos de tiempo de ejecución ahora viven en jobs-state.json.
• Cuando se edita jobs.json mientras el Gateway está en ejecución o detenido, OpenClaw compara los campos de programación modificados con los metadatos de la ranura de tiempo de ejecución pendiente y borra los valores obsoletos de nextRunAtMs. Las reescrituras de formato puro o solo de orden de claves preservan la ranura pendiente.
• Todas las ejecuciones de cron crean registros de tarea en segundo plano.
• Al iniciar Gateway, los trabajos aislados de turno del agente vencidos se reprograman fuera de la ventana de conexión del canal en lugar de reproducirse inmediatamente, por lo que el inicio de Discord/Telegram y la configuración de comandos nativos permanecen receptivos después de los reinicios.
• Los trabajos de un solo uso (--at) se eliminan automáticamente después del éxito de forma predeterminada.
• Las ejecuciones de cron aisladas cierran, con el mejor esfuerzo posible, las pestañas/procesos del navegador rastreados para su sesión cron:<jobId> cuando se completa la ejecución, por lo que la automatización del navegador desacoplada no deja procesos huérfanos.
• Las ejecuciones de cron aisladas que reciben la subvención estrecha de autolimpieza de cron aún pueden leer el estado del programador, una lista autofiltrada de su trabajo actual y el historial de ejecuciones de ese trabajo, de modo que las verificaciones de estado/latido puedan inspeccionar su propio programa sin obtener acceso de mutación de cron más amplio.
• Las ejecuciones de cron aisladas también protegen contra respuestas de reconocimiento obsoletas. Si el primer resultado es solo una actualización de estado interina (on it, pulling everything together e indicaciones similares) y ninguna ejecución de subagente descendente sigue siendo responsable de la respuesta final, OpenClaw vuelve a solicitar una vez el resultado real antes de la entrega.
• Las ejecuciones de cron aisladas utilizan metadatos estructurados de denegación de ejecución de la ejecución incrustada, incluyendo los envoltorios del nodo host UNAVAILABLE cuyo mensaje de error anidado comienza con SYSTEM_RUN_DENIED o INVALID_REQUEST, por lo que un comando bloqueado no se reporta como una ejecución correcta (verde), mientras que la prosa ordinaria del asistente no se trata como una denegación.
• Las ejecuciones de cron aisladas también tratan los fallos del agente a nivel de ejecución como errores del trabajo incluso cuando no se produce ninguna carga útil de respuesta, de modo que los fallos del modelo/proveedor incrementan los contadores de errores y activan notificaciones de fallo en lugar de marcar el trabajo como exitoso.
• Cuando un trabajo de turno de agente aislado alcanza timeoutSeconds, cron aborta la ejecución del agente subyacente y le da una breve ventana de limpieza. Si la ejecución no se drena, la limpieza propiedad de Gateway borra forzosamente la propiedad de la sesión de esa ejecución antes de que cron registre el tiempo de espera, para que el trabajo de chat en cola no se quede atrás de una sesión de procesamiento obsoleta.
• Si un turno de agente aislado se detiene antes de que se inicie el ejecutor o antes de la primera llamada al modelo, cron registra un tiempo de espera específico de la fase, como setup timed out before runner start o stalled before first model call (last phase: context-engine). Estos perros guardianes cubren a los proveedores incrustados y a los proveedores respaldados por CLI antes de que su proceso CLI externo se inicie realmente, y están limitados de forma independiente a los largos valores de timeoutSeconds para que los fallos de inicio en frío/autenticación/contexto aparezcan rápidamente en lugar de esperar el presupuesto completo del trabajo.

Note

La conciliación de tareas para cron es propiedad primero del tiempo de ejecución y respaldada en segundo lugar por el historial duradero: una tarea de cron activa permanece viva mientras el tiempo de ejecución de cron todavía rastrea ese trabajo como en ejecución, incluso si todavía existe una fila de sesión secundaria antigua. Una vez que el tiempo de ejecución deja de ser propietario del trabajo y expira la ventana de gracia de 5 minutos, el mantenimiento verifica los registros de ejecución persistidos y el estado del trabajo para la ejecución coincidente `cron:

:

. Si ese historial duradero muestra un resultado terminal, el libro mayor de tareas se finaliza a partir de él; de lo contrario, el mantenimiento propiedad de Gateway puede marcar la tarea como lost`. La auditoría de CLI sin conexión puede recuperarse del historial duradero, pero no trata su propio conjunto vacío de trabajos activos en proceso como prueba de que una ejecución de cron propiedad de Gateway ha desaparecido.

Tipos de programación

Tipo	Opción de CLI	Descripción
at	--at	Marca de tiempo de un solo disparo (ISO 8601 o relativa como 20m)
every	--every	Intervalo fijo
cron	--cron	Expresión cron de 5 o 6 campos con --tz opcional

Las marcas de tiempo sin zona horaria se tratan como UTC. Agregue --tz America/New_York para la programación de reloj de pared local.

Las expresiones recurrentes al inicio de la hora se escalonan automáticamente hasta 5 minutos para reducir picos de carga. Use --exact para forzar una sincronización precisa o --stagger 30s para una ventana explícita.

Día del mes y día de la semana usan lógica OR

Las expresiones cron se analizan mediante croner. Cuando tanto los campos de día del mes como de día de la semana no son comodines, croner coincide cuando cualquiera de los campos coincide, no ambos. Este es el comportamiento estándar de cron Vixie.

# Intended: "9 AM on the 15th, only if it's a Monday"
# Actual:   "9 AM on every 15th, AND 9 AM on every Monday"
0 9 15 * 1

Esto se dispara ~5-6 veces por mes en lugar de 0-1 veces por mes. OpenClaw usa el comportamiento OR predeterminado de Croner aquí. Para requerir ambas condiciones, use el modificador de día de la semana + de Croner (0 9 15 * +1) o programe en un campo y proteja el otro en el indicador o comando de su trabajo.

Estilos de ejecución

Estilo	Valor --session	Se ejecuta en	Mejor para
Sesión principal	main	Carril dedicado de activación de cron	Recordatorios, eventos del sistema
Aislado	isolated	cron:<jobId> dedicado	Informes, tareas de fondo
Sesión actual	current	Vinculado en el momento de creación	Trabajo recurrente consciente del contexto
Sesión personalizada	session:custom-id	Sesión con nombre persistente	Flujos de trabajo que se basan en el historial

Sesión principal vs aislada vs personalizada

Los trabajos de Sesión principal ponen en cola un evento del sistema en un carril de ejecución propiedad de cron y opcionalmente despiertan el latido (--wake now o --wake next-heartbeat). Pueden usar el contexto de última entrega de la sesión principal de destino para las respuestas, pero no agregan turnos de cron de rutina al carril de chat humano y no extienden la frescura de restablecimiento diario/inactivo para la sesión de destino. Los trabajos Aislados ejecutan un turno de agente dedicado con una sesión nueva. Las Sesiones personalizadas (session:xxx) mantienen el contexto entre ejecuciones, lo que permite flujos de trabajo como reuniones diarias que se basan en resúmenes anteriores.

Lo que significa 'sesión nueva' para trabajos aislados

Para trabajos aislados, “sesión nueva” significa un nuevo id de transcripción/sesión para cada ejecución. OpenClaw puede llevar preferencias seguras como la configuración de pensamiento/rápido/verboso, etiquetas y anulaciones explícitas de modelo/autenticación seleccionadas por el usuario, pero no hereda el contexto de conversación ambiental de una fila cron anterior: enrutamiento de canal/grupo, política de envío o cola, elevación, origen o enlace de tiempo de ejecución de ACP. Use current o `session:

` cuando un trabajo recurrente deba basarse deliberadamente en el mismo contexto de conversación.

Limpieza del tiempo de ejecución

Para los trabajos aislados, el desmontaje del tiempo de ejecución ahora incluye la limpieza del navegador con el mejor esfuerzo para esa sesión cron. Los fallos de limpieza se ignoran para que el resultado cron real aún prevalezca.

Las ejecuciones cron aisladas también eliminan cualquier instancia del tiempo de ejecución de MCP empaquetada creada para el trabajo a través de la ruta compartida de limpieza del tiempo de ejecución. Esto coincide con la forma en que se desmontan los clientes MCP de sesión principal y sesión personalizada, por lo que los trabajos cron aislados no filtran procesos secundarios stdio ni conexiones MCP de larga duración entre ejecuciones.

Entrega de subagente y Discord

Cuando las ejecuciones cron aisladas orquestan subagentes, la entrega también prefiere la salida del descendiente final sobre el texto intermedio del padre obsoleto. Si los descendentes todavía se están ejecutando, OpenClaw suprime esa actualización parcial del padre en lugar de anunciarla.

Para los objetivos de anuncio de Discord de solo texto, OpenClaw envía el texto final canónico del asistente una vez en lugar de reproducir tanto las cargas útiles de texto transmitidas/intermedias como la respuesta final. Los elementos multimedia y las cargas útiles estructuradas de Discord aún se entregan como cargas útiles separadas para que no se pierdan los archivos adjuntos ni los componentes.

Opciones de carga útil para trabajos aislados

Texto del prompt (requerido para trabajos aislados). Anulación del modelo; usa el modelo permitido seleccionado para el trabajo. Anulación del nivel de pensamiento. Omitir la inyección del archivo de inicio del espacio de trabajo. Restringir qué herramientas puede usar el trabajo, por ejemplo `--tools exec,read`.

--model usa el modelo permitido seleccionado como el modelo principal de ese trabajo. No es lo mismo que una anulación /model de sesión de chat: las cadenas de respaldo configuradas todavía se aplican cuando falla el principal del trabajo. Si el modelo solicitado no está permitido o no se puede resolver, cron falla la ejecución con un error de validación explícito en lugar de recurrir silenciosamente a la selección de modelo agente/predeterminado del trabajo.

Los trabajos cron también pueden llevar fallbacks a nivel de carga útil. Cuando están presentes, esa lista reemplaza la cadena de respaldo configurada para el trabajo. Use fallbacks: [] en la carga útil/API del trabajo cuando desee una ejecución cron estricta que intente solo el modelo seleccionado. Si un trabajo tiene --model pero ni respaldos de carga útil ni configurados, OpenClaw pasa una anulación de respaldo vacía explícita para que el principal del agente no se agregue como un objetivo de reintento extra oculto.

La precedencia de selección de modelo para trabajos aislados es:

1. Sobrescritura del modelo del gancho de Gmail (cuando la ejecución proviene de Gmail y se permite esa sobrescritura)
2. Carga útil por trabajo model
3. Sobrescritura del modelo de sesión de cron almacenada seleccionada por el usuario
4. Selección del modelo agente/predeterminado

El modo rápido también sigue la selección en vivo resuelta. Si la configuración del modelo seleccionado tiene params.fastMode, el cron aislado usa eso de forma predeterminada. Una anulación de sesión fastMode almacenada todavía tiene prioridad sobre la configuración en cualquier dirección.

Si una ejecución aislada encuentra una transferencia en vivo de cambio de modelo, cron reintenta con el proveedor/modelo cambiado y persiste esa selección en vivo para la ejecución activa antes de reintentar. Cuando el cambio también lleva un nuevo perfil de autenticación, cron también persiste esa anulación del perfil de autenticación para la ejecución activa. Los reintentos están limitados: después del intento inicial más 2 reintentos de cambio, cron aborta en lugar de entrar en un bucle infinito.

Antes de que una ejecución de cron aislada entre en el ejecutor del agente, OpenClaw verifica los endpoints de proveedores locales alcanzables para proveedores configurados api: "ollama" y api: "openai-completions" cuyo baseUrl sea loopback, red privada o .local. Si ese endpoint está caído, la ejecución se registra como skipped con un error claro de proveedor/modelo en lugar de iniciar una llamada al modelo. El resultado del endpoint se almacena en caché durante 5 minutos, por lo que muchos trabajos pendientes que usan el mismo servidor local Ollama, vLLM, SGLang o LM Studio muerto comparten una pequeña sond en lugar de crear una tormenta de solicitudes. Las ejecuciones omitidas de verificación previa del proveedor no incrementan el retroceso por error de ejecución; habilite failureAlert.includeSkipped cuando desee notificaciones repetidas de omisión.

Entrega y salida

Modo	Qué sucede
announce	Entrega de reserva del texto final al objetivo si el agente no envió
webhook	PUBLICAR carga útil del evento finalizado en una URL
none	Sin entrega de reserva del ejecutor

Use --announce --channel telegram --to "-1001234567890" para la entrega al canal. Para temas de foros de Telegram, use -1001234567890:topic:123; los llamantes directos de RPC/configuración también pueden pasar delivery.threadId como una cadena o número. Los objetivos de Slack/Discord/Mattermost deben usar prefijos explícitos (channel:<id>, user:<id>). Los IDs de sala de Matrix distinguen entre mayúsculas y minúsculas; use el ID de sala exacto o el formato room:!room:server de Matrix.

Cuando la entrega de anuncios utiliza channel: "last" o omite channel, un destino con prefijo de proveedor como telegram:123 puede seleccionar el canal antes de que cron recurra al historial de sesión o a un solo canal configurado. Solo los prefijos anunciados por el complemento cargado son selectores de proveedor. Si delivery.channel es explícito, el prefijo de destino debe nombrar al mismo proveedor; por ejemplo, channel: "whatsapp" con to: "telegram:123" se rechaza en lugar de dejar que WhatsApp interprete el ID de Telegram como un número de teléfono. Los prefijos de tipo de destino y de servicio como channel:<id>, user:<id>, imessage:<handle> y sms:<number> siguen siendo sintaxis de destino propiedad del canal, no selectores de proveedor.

Para los trabajos aislados, la entrega de chat se comparte. Si hay una ruta de chat disponible, el agente puede usar la herramienta message incluso cuando el trabajo usa --no-deliver. Si el agente envía al destino configurado/actual, OpenClaw omite el anuncio de reserva. De lo contrario, announce, webhook y none solo controlan lo que el ejecutor hace con la respuesta final después del turno del agente.

Cuando un agente crea un recordatorio aislado desde un chat activo, OpenClaw almacena el destino de entrega en vivo preservado para la ruta de anuncio de reserva. Las claves de sesión interna pueden estar en minúsculas; los destinos de entrega del proveedor no se reconstruyen a partir de esas claves cuando el contexto de chat actual está disponible.

La entrega implícita de anuncios usa listas de permitidos de canales configuradas para validar y redirigir destinos obsoletos. Las aprobaciones de la tienda de emparejamiento de MD no son destinatarios de automatización de reserva; establezca delivery.to o configure la entrada de canal allowFrom cuando un trabajo programado debe enviar proactivamente a un MD.

Las notificaciones de error siguen una ruta de destino separada:

• cron.failureDestination establece un valor predeterminado global para las notificaciones de falla.
• job.delivery.failureDestination anula eso por trabajo.
• Si ninguno está configurado y el trabajo ya entrega a través de announce, las notificaciones de falla ahora recurren a ese destino de anuncio principal.
• delivery.failureDestination solo es compatible con trabajos sessionTarget="isolated" a menos que el modo de entrega principal sea webhook.
• failureAlert.includeSkipped: true activa una alerta de ejecución omitida repetida para un trabajo o una política de alertas cron global. Las ejecuciones omitidas mantienen un contador consecutivo de omisiones separado, por lo que no afectan al retroceso por error de ejecución.

Ejemplos de CLI

Recordatorio de un solo usoTrabajo aislado recurrenteModelo y anulación de pensamiento

bash openclaw cron add \ --name "Calendar check" \ --at "20m" \ --session main \ --system-event "Next heartbeat: check calendar." \ --wake now

bash openclaw cron add \ --name "Morning brief" \ --cron "0 7 * * *" \ --tz "America/Los_Angeles" \ --session isolated \ --message "Summarize overnight updates." \ --announce \ --channel slack \ --to "channel:C1234567890"

bash openclaw cron add \ --name "Deep analysis" \ --cron "0 6 * * 1" \ --tz "America/Los_Angeles" \ --session isolated \ --message "Weekly deep analysis of project progress." \ --model "opus" \ --thinking high \ --announce

Webhooks

Gateway puede exponer puntos finales de webhook HTTP para desencadenadores externos. Activar en la configuración:

{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks",
  },
}

Autenticación

Cada solicitud debe incluir el token de enlace a través del encabezado:

• Authorization: Bearer <token> (recomendado)
• x-openclaw-token: <token>

Los tokens de cadena de consulta se rechazan.

POST /hooks/wake

Poner en cola un evento del sistema para la sesión principal:

curl -X POST http://127.0.0.1:18789/hooks/wake \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"text":"New email received","mode":"now"}'

Descripción del evento.

now o next-heartbeat.

POST /hooks/agent

Ejecutar un turno de agente aislado:

curl -X POST http://127.0.0.1:18789/hooks/agent \
  -H 'Authorization: Bearer SECRET' \
  -H 'Content-Type: application/json' \
  -d '{"message":"Summarize inbox","name":"Email","model":"openai/gpt-5.4"}'

Campos: message (obligatorio), name, agentId, wakeMode, deliver, channel, to, model, fallbacks, thinking, timeoutSeconds.

Mapped hooks (POST /hooks/<name>)

Los nombres de hooks personalizados se resuelven mediante hooks.mappings en la configuración. Las asignaciones pueden transformar cargas útiles arbitrarias en acciones wake o agent con plantillas o transformaciones de código.

Warning

Mantenga los endpoints de los hooks detrás de un loopback, tailnet o un proxy inverso de confianza.

• Utilice un token de hook dedicado; no reutilice los tokens de autenticación de la puerta de enlace.
• Mantenga hooks.path en una subruta dedicada; / se rechaza.
• Establezca hooks.allowedAgentIds para limitar el enrutamiento explícito de agentId.
• Mantenga hooks.allowRequestSessionKey=false a menos que requiera sesiones seleccionadas por el llamador.
• Si habilita hooks.allowRequestSessionKey, también establezca hooks.allowedSessionKeyPrefixes para restringir las formas permitidas de las claves de sesión.
• Las cargas útiles de los hooks se envuelven con límites de seguridad de forma predeterminada.

Integración con Gmail PubSub

Conecte los disparadores de la bandeja de entrada de Gmail a OpenClaw a través de Google PubSub.

Note

Requisitos previos:

CLI

gcloud

,

gog

(gogcli), hooks de OpenClaw habilitados, Tailscale para el endpoint HTTPS público.

Configuración mediante asistente (recomendado)

openclaw webhooks gmail setup --account [email protected]

Esto escribe la configuración de hooks.gmail, habilita el preajuste de Gmail y usa Tailscale Funnel para el endpoint de inserción.

Inicio automático de la puerta de enlace

Cuando se establecen hooks.enabled=true y hooks.gmail.account, la Gateway inicia gog gmail watch serve al arrancar y renueva automáticamente la vigilancia. Establezca OPENCLAW_SKIP_GMAIL_WATCHER=1 para no participar.

Configuración manual única

1. Seleccione el proyecto de GCP

   Seleccione el proyecto de GCP que posee el cliente de OAuth utilizado por gog:

   gcloud auth login
   gcloud config set project

   gcloud services enable gmail.googleapis.com pubsub.googleapis.com

2. Crear tema y otorgar acceso de push de Gmail

   gcloud pubsub topics create gog-gmail-watch
   gcloud pubsub topics add-iam-policy-binding gog-gmail-watch \
     --member=serviceAccount:[email protected] \
     --role=roles/pubsub.publisher

3. Iniciar la vigilancia

   gog gmail watch start \
     --account [email protected] \
     --label INBOX \
     --topic projects/

   /topics/gog-gmail-watch ```

Anulación del modelo de Gmail

{
  hooks: {
    gmail: {
      model: "openrouter/meta-llama/llama-3.3-70b-instruct:free",
      thinking: "off",
    },
  },
}

Gestión de trabajos

# List all jobs
openclaw cron list

# Get one stored job as JSON
openclaw cron get <jobId>

# Show one job, including resolved delivery route
openclaw cron show <jobId>

# Edit a job
openclaw cron edit <jobId> --message "Updated prompt" --model "opus"

# Force run a job now
openclaw cron run <jobId>

# Force run a job now and wait for its terminal status
openclaw cron run <jobId> --wait --wait-timeout 10m --poll-interval 2s

# Run only if due
openclaw cron run <jobId> --due

# View run history
openclaw cron runs --id <jobId> --limit 50

# View one exact run
openclaw cron runs --id <jobId> --run-id <runId>

# Delete a job
openclaw cron remove <jobId>

# Agent selection (multi-agent setups)
openclaw cron add --name "Ops sweep" --cron "0 6 * * *" --session isolated --message "Check ops queue" --agent ops
openclaw cron edit <jobId> --clear-agent

openclaw cron run <jobId> regresa después de poner en cola la ejecución manual. Use --wait para hooks de apagado, scripts de mantenimiento u otra automatización que debe bloquearse hasta que finalice la ejecución en cola. El modo de espera sonde el runId exacto devuelto; sale con 0 para el estado ok y con un valor distinto de cero para error, skipped o un tiempo de espera de espera.

Note

Nota sobre la anulación del modelo:

• openclaw cron add|edit --model ... cambia el modelo seleccionado del trabajo.
• Si el modelo está permitido, ese proveedor/modelo exacto llega a la ejecución del agente aislado.
• Si no está permitido o no se puede resolver, cron falla la ejecución con un error de validación explícito.
• Las cadenas de reserva configuradas todavía se aplican porque cron --model es un primario del trabajo, no una anulación de /model de sesión.
• Payload fallbacks reemplaza las reservas configuradas para ese trabajo; fallbacks: [] desactiva la reserva y hace que la ejecución sea estricta.
• Un --model simple sin una lista de reserva explícita o configurada no recurre al primario del agente como un objetivo de reintento adicional silencioso.

Configuración

{
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 1,
    retry: {
      maxAttempts: 3,
      backoffMs: [60000, 120000, 300000],
      retryOn: ["rate_limit", "overloaded", "network", "server_error"],
    },
    webhookToken: "replace-with-dedicated-webhook-token",
    sessionRetention: "24h",
    runLog: { maxBytes: "2mb", keepLines: 2000 },
  },
}

maxConcurrentRuns limita tanto el despacho de cron programado como la ejecución del turno del agente aislado. Los turnos del agente cron aislados utilizan internamente el carril de ejecución dedicado cron-nested de la cola, por lo que aumentar este valor permite que las ejecuciones de LLM de cron independientes progresen en paralelo en lugar de solo iniciar sus envoltorios de cron externos. El carril compartido no-cron nested no se amplía con esta configuración.

El sidecar del estado de tiempo de ejecución se deriva de cron.store: un almacén .json como ~/clawd/cron/jobs.json usa ~/clawd/cron/jobs-state.json, mientras que una ruta de almacén sin un sufijo .json añade -state.json.

Si edita manualmente jobs.json, deje jobs-state.json fuera del control de código fuente. OpenClaw usa ese sidecar para ranuras pendientes, marcadores activos, metadatos de última ejecución y la identidad del programa que indica al planificador cuándo un trabajo editado externamente necesita un nextRunAtMs nuevo.

Desactivar cron: cron.enabled: false o OPENCLAW_SKIP_CRON=1.

Comportamiento de reintento

Reintento de una sola vez: los errores transitorios (límite de velocidad, sobrecarga, red, error del servidor) se reintentan hasta 3 veces con retroceso exponencial. Los errores permanentes se desactivan inmediatamente.

Reintento recurrente: retroceso exponencial (30s a 60m) entre reintentos. El retroceso se restablece después de la siguiente ejecución exitosa.

Mantenimiento

cron.sessionRetention (por defecto 24h) poda las entradas de sesión de ejecución aisladas. cron.runLog.maxBytes / cron.runLog.keepLines auto-podan los archivos de registro de ejecución.

Solución de problemas

Escalera de comandos

openclaw status
openclaw gateway status
openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw system heartbeat last
openclaw logs --follow
openclaw doctor

Cron no se ejecuta

• Verifique las variables de entorno cron.enabled y OPENCLAW_SKIP_CRON.
• Confirme que la Gateway se está ejecutando continuamente.
• Para las programaciones cron, verifique la zona horaria (--tz) frente a la zona horaria del host.
• reason: not-due en la salida de ejecución significa que se verificó una ejecución manual con `openclaw cron run

—due` y que el trabajo aún no debía ejecutarse.

Cron se ejecutó pero no hubo entrega

• El modo de entrega none significa que no se espera un envío de respaldo del ejecutor. El agente aún puede enviar directamente con la herramienta message cuando hay una ruta de chat disponible.
• El destino de entrega faltante/no válido (channel/to) significa que se omitió el envío saliente.
• Para Matrix, los trabajos copiados o heredados con IDs de sala delivery.to en minúsculas pueden fallar porque los IDs de sala de Matrix distinguen entre mayúsculas y minúsculas. Edite el trabajo con el valor exacto !room:server o room:!room:server de Matrix.
• Los errores de autenticación del canal (unauthorized, Forbidden) significan que la entrega fue bloqueada por las credenciales.
• Si la ejecución aislada devuelve solo el token silencioso (NO_REPLY / no_reply), OpenClaw suprime la entrega saliente directa y también suprime la ruta de resumen en cola de respaldo, por lo que no se publica nada de nuevo en el chat.
• Si el agente debe enviarle un mensaje al usuario, verifique que el trabajo tenga una ruta utilizable (channel: "last" con un chat anterior, o un canal/destino explícito).

Cron o heartbeat parece prevenir el cambio a /new-style

• La frescura del restablecimiento diario e inactivo no se basa en updatedAt; consulte Gestión de sesiones.
• Las activaciones de Cron, ejecuciones de heartbeat, notificaciones de exec y mantenimiento del gateway pueden actualizar la fila de la sesión para el enrutamiento/estado, pero no extienden sessionStartedAt ni lastInteractionAt.
• Para las filas heredadas creadas antes de que existieran esos campos, OpenClaw puede recuperar sessionStartedAt del encabezado de sesión JSONL de la transcripción cuando el archivo aún está disponible. Las filas inactivas heredadas sin lastInteractionAt utilizan esa hora de inicio recuperada como su línea base inactiva.

Problemas de zona horaria

• Cron sin --tz utiliza la zona horaria del host gateway.
• Los horarios at sin zona horaria se tratan como UTC.
• El activeHours de Heartbeat utiliza la resolución de zona horaria configurada.

Relacionado

• Automatización — todos los mecanismos de automatización de un vistazo
• Tareas en segundo plano — libro mayor de tareas para ejecuciones de cron
• Heartbeat — turnos periódicos de la sesión principal
• Zona horaria — configuración de zona horaria