Cron jobs de OpenClaw: programa tu agente de IA (guía completa)

Una de las funcionalidades más potentes de OpenClaw es la capacidad de programar tu agente de IA para que ejecute tareas automáticamente. En lugar de pedirle a tu agente que haga algo cada mañana, lo programas una vez y se ejecuta para siempre. Esta guía cubre todo sobre los cron jobs de OpenClaw, desde la sintaxis básica hasta los patrones de programación avanzados.

¿Qué son los cron jobs de OpenClaw?

Los cron jobs de OpenClaw son prompts programados que se ejecutan a horas determinadas. Cuando se activa un cron job, envía un mensaje a tu agente como si lo hubieras escrito tú mismo. El agente lo procesa, ejecuta las skills necesarias y puede enviar los resultados a tus canales o correo electrónico.

Piensa en ellos como conversaciones automatizadas. En lugar de que tú digas "Dame un informe meteorológico cada mañana", el cron job lo dice por ti.

Comandos básicos

Añadir un cron job

# Basic syntax
openclaw cron add "schedule" "prompt"

# Example: Daily weather at 7:30 AM
openclaw cron add "30 7 * * *" "What's the weather forecast for today? Send a brief summary."

# With a name for easy management
openclaw cron add --name "morning-weather" "30 7 * * *" "Weather forecast summary for today"

Listar todos los cron jobs

openclaw cron list

# Output:
# ID    Name              Schedule       Next Run           Status
# 1     morning-weather   30 7 * * *     2026-04-06 07:30   active
# 2     weekly-report     0 17 * * 5     2026-04-11 17:00   active
# 3     health-check      */5 * * * *    2026-04-05 14:35   active

Eliminar un cron job

# By ID
openclaw cron remove 1

# By name
openclaw cron remove --name "morning-weather"

Pausar y reanudar

# Pause without deleting
openclaw cron pause 1

# Resume
openclaw cron resume 1

Ejecutar manualmente

# Test a cron job immediately
openclaw cron run 1

# Or by name
openclaw cron run --name "morning-weather"

Sintaxis de programación de cron

OpenClaw usa la sintaxis cron estándar con cinco campos:

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-7, 0 and 7 = Sunday)
│ │ │ │ │
* * * * *

Programaciones comunes

Expresiones abreviadas

OpenClaw también admite abreviaturas legibles:

openclaw cron add --every "day at 7:30am" "Morning briefing"
openclaw cron add --every "hour" "Check server status"
openclaw cron add --every "monday at 10am" "Weekly team summary"
openclaw cron add --every "weekday at 9am" "Start of day tasks"

Ejemplos prácticos

Resumen matutino

Un resumen diario de todo lo que necesitas saber:

openclaw cron add --name "morning-briefing" "30 7 * * *" \
  "Good morning! Give me today's briefing:
   1. Weather forecast
   2. Calendar events for today
   3. Unread emails summary (top 5)
   4. Top news headlines
   Send the summary to my Telegram."

Informe diario por correo electrónico

Genera un informe y envíalo por correo a tu equipo:

openclaw cron add --name "daily-report" "0 17 * * 1-5" \
  "Generate a daily activity report:
   - Tasks completed today
   - Issues encountered
   - Tomorrow's priorities
   Format as a clean email and send via Inbounter to team@company.com"

Si usas Inbounter para la entrega de correo, el agente puede enviar correos HTML formateados directamente a través de la API.

Resumen semanal

openclaw cron add --name "weekly-summary" "0 17 * * 5" \
  "It's Friday! Generate a weekly summary:
   - Key accomplishments this week
   - Metrics and trends
   - Plans for next week
   Send to my Telegram and email it to me via Inbounter."

Comprobación de estado del servidor

openclaw cron add --name "health-check" "*/15 * * * *" \
  "Run a quick server health check:
   - Check disk usage (alert if > 80%)
   - Check memory usage
   - Check if all services are running
   - Check SSL certificate expiry
   Only message me if something is wrong."

Recordatorio de copia de seguridad de la base de datos

openclaw cron add --name "backup-reminder" "0 2 * * *" \
  "Run the database backup script at /home/user/scripts/backup.sh
   and verify the backup was created successfully.
   If the backup fails, send an urgent notification via Inbounter SMS."

Resumen de feeds RSS

openclaw cron add --name "rss-digest" "0 8 * * *" \
  "Check my RSS feeds and create a morning digest:
   - AI/ML news
   - Tech industry news
   - Hacker News top 5 stories
   Summarize each article in 2-3 sentences. Send to Telegram."

Manejo de la zona horaria

Los cron jobs se ejecutan en la zona horaria configurada en los ajustes de tu OpenClaw. Es fundamental acertar con esto o tu resumen matutino se activará a las 3 de la madrugada.

Comprueba tu zona horaria

openclaw config get timezone

Configura tu zona horaria

openclaw config set timezone "America/New_York"

O en config.yaml:

system:
  timezone: "America/New_York"

Identificadores de zona horaria disponibles

Usa nombres de zona horaria IANA estándar:

• America/New_York (Este)
• America/Chicago (Central)
• America/Denver (Montaña)
• America/Los_Angeles (Pacífico)
• Europe/London
• Europe/Berlin
• Asia/Tokyo
• Asia/Kolkata
• Australia/Sydney

Gestión de los cambios de horario de verano (DST)

OpenClaw se ajusta automáticamente a los cambios de horario de verano. Una tarea programada para las 7:00 AM siempre se ejecutará a las 7:00 AM hora local, independientemente de las transiciones de DST.

Manejo de errores

¿Qué ocurre cuando falla un cron job?

Si el agente encuentra un error durante un cron job:

1. El error se registra en el historial de ejecución del cron job
2. La siguiente ejecución programada continúa con normalidad
3. Opcionalmente, se envía una notificación

Configurar notificaciones de error

cron:
  error_handling:
    notify_on_failure: true
    notification_channel: "telegram"
    max_retries: 2
    retry_delay: 300  # 5 minutes

Ver el historial de ejecución

# See recent cron job executions
openclaw cron history

# For a specific job
openclaw cron history --name "morning-briefing" --limit 10

# Output:
# Time                  Job               Status    Duration
# 2026-04-05 07:30:00   morning-briefing  success   12.3s
# 2026-04-04 07:30:00   morning-briefing  success   14.1s
# 2026-04-03 07:30:00   morning-briefing  failed    3.2s

Depurar tareas fallidas

# View the full output of a specific execution
openclaw cron history --name "morning-briefing" --id 42 --verbose

# Run the job interactively for debugging
openclaw cron run --name "morning-briefing" --debug

Patrones avanzados

Encadenar cron jobs

Ejecuta tareas en secuencia estableciendo dependencias:

openclaw cron add --name "collect-data" "0 6 * * *" \
  "Collect today's metrics from all data sources"

openclaw cron add --name "generate-report" --after "collect-data" \
  "Generate a report from the collected metrics"

Ejecución condicional

Incluye condiciones en tus prompts:

openclaw cron add --name "rainy-day-alert" "0 7 * * *" \
  "Check the weather. If rain is forecast for today, send me a Telegram message saying 'Bring an umbrella!' If no rain, do nothing."

Sustitución de variables

Usa variables de plantilla en los prompts de cron:

openclaw cron add --name "daily-standup" "0 9 * * 1-5" \
  "Today is {{date}}. Generate a standup update:
   - What was completed yesterday ({{yesterday}})
   - What is planned for today
   - Any blockers"

Limitación de tasa

Evita que los cron jobs agoten tu presupuesto de LLM:

cron:
  rate_limit:
    max_concurrent: 1        # One job at a time
    min_interval: 60         # At least 60s between jobs
    daily_budget: 100000     # Max tokens for cron per day

Monitorización de los cron jobs

Panel de estado

# Quick overview
openclaw cron status

# Output:
# Total jobs: 5
# Active: 4
# Paused: 1
# Last execution: 2026-04-05 14:30:00 (health-check) - success
# Next execution: 2026-04-05 14:45:00 (health-check)
# Today's token usage: 12,340 / 100,000

Resúmenes por correo electrónico

Configura un resumen diario de la actividad de los cron jobs enviado vía Inbounter:

cron:
  daily_summary:
    enabled: true
    time: "23:00"
    provider: "inbounter"
    email: "you@gmail.com"

Errores comunes

1. Tareas que se ejecutan a horas inesperadas

Casi siempre es un problema de zona horaria. Verifícalo con:

openclaw config get timezone
date  # Compare with system time

2. Tareas que no se ejecutan en absoluto

# Check if the cron service is running
openclaw cron status

# Restart the cron service
openclaw cron restart

3. Agotamiento del presupuesto de tokens

Los cron jobs frecuentes (cada 5 minutos) pueden consumir una cantidad significativa de tokens. Calcula tu coste mensual estimado:

• 12 ejecuciones/hora x 24 horas x 30 días = 8.640 ejecuciones/mes
• A ~2.000 tokens por ejecución = 17,3M de tokens/mes
• Con los precios de Claude Sonnet = ~70 $/mes solo por esta tarea

Usa modelos más baratos para los cron jobs rutinarios:

openclaw cron add --model "gemini-flash" "*/5 * * * *" "Quick server check"

4. Ejecuciones superpuestas

Si una tarea tarda más que el intervalo entre ejecuciones, configura la prevención de solapamientos:

cron:
  prevent_overlap: true  # Skip run if previous is still executing

Preguntas frecuentes

¿Pueden los cron jobs enviar mensajes a canales específicos?

Sí. Incluye el canal en tu prompt: "Send the result to my Telegram" o "Email this to me via Inbounter".

¿Cuentan los cron jobs para mis límites de uso de la API?

Sí. Cada ejecución de cron es una llamada a la API. Presupuesta en consecuencia.

¿Puedo importar cron jobs desde un archivo?

Sí:

openclaw cron import cron-jobs.yaml
openclaw cron export > cron-jobs.yaml

¿Qué les ocurre a los cron jobs durante un reinicio?

Los cron jobs se conservan en la base de datos. Tras un reinicio, todos los cron jobs activos se reanudan automáticamente. Las tareas que se perdieron durante el tiempo de inactividad se omiten (no se ejecutan de forma retroactiva).

¿Pueden los cron jobs acceder a la memoria del agente?

Sí. Los cron jobs se ejecutan en el mismo contexto que los mensajes interactivos. El agente tiene acceso a toda su memoria y a SOUL.md durante la ejecución del cron.

¿Cuántos cron jobs puedo tener?

No hay un límite estricto. Los límites prácticos dependen de tu presupuesto de tokens y de los recursos del servidor. La mayoría de los usuarios tienen entre 5 y 15 cron jobs activos.

¿Necesitas que tus tareas programadas de OpenClaw envíen correos electrónicos o SMS? Inbounter ofrece APIs de entrega fiables diseñadas para la automatización de agentes de IA. Perfecto para las notificaciones e informes de los cron jobs.