Configurando Automatización

Prerrequisitos

Antes de comenzar, asegúrate de tener:

• OpenClaw instalado y ejecutándose - Completa el Tutorial de Primeros Pasos
• Un canal conectado - Sigue el Tutorial de Configuración de Canales
• Gateway ejecutándose - Tu Gateway de OpenClaw debe estar activo
• Comprensión básica de sintaxis cron - Lo explicaremos, pero la familiaridad ayuda

OpenClaw soporta varios tipos de automatización:

Para este tutorial, nos enfocaremos en trabajos cron - el tipo de automatización más común. Ver la Referencia de Automatización para webhooks y otros tipos.

Antes de escribir la configuración, planifiquemos qué hará nuestra automatización:

Detalles de la Automatización

• Qué: Enviar un mensaje de resumen diario
• Cuándo: Cada mañana a las 9:00 AM
• Cómo: Usar el agente de OpenClaw para generar y enviar el resumen
• Dónde: Enviar a tu canal conectado (Telegram, WhatsApp, etc.)

Entendiendo la Sintaxis Cron

Cron usa un formato de programación basado en tiempo:

┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of week (0 - 6) (Sunday to Saturday)
│ │ │ │ │
* * * * *

Ahora agreguemos la automatización a tu configuración de OpenClaw.

Paso 3.1: Abrir Archivo de Configuración

Abre tu archivo de configuración de OpenClaw:

nano ~/.openclaw/openclaw.json
# or use your preferred editor

Paso 3.2: Agregar Configuración Cron

Agrega la sección cron a tu configuración. Aquí hay un ejemplo completo:

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-opus-4-5" }
    }
  },
  "cron": {
    "enabled": true,
    "jobs": [
      {
        "name": "Daily briefing",
        "cron": "0 9 * * *",
        "message": "Create my daily briefing for today. Include: weather summary, calendar events, and any important reminders.",
        "session": "isolated"
      }
    ]
  }
}

Lo que hace esto:

• "cron": "0 9 * * *" - Se ejecuta a las 9:00 AM cada día
• "message" - El mensaje enviado al agente

El agente procesará el mensaje y enviará la respuesta a tu canal conectado.

Después de agregar tu configuración de automatización:

• Guarda el archivo de configuración
• Reinicia tu Gateway para cargar la nueva automatización

# If running as service:
openclaw gateway restart

# Or if running manually, stop and restart:
openclaw gateway --port 18789 --verbose

El Gateway ahora cargará tus trabajos cron y los programará según tu horario.

¡No tienes que esperar hasta las 9 AM para probar! Verifiquemos que funciona:

Método A: Probar Inmediatamente

Ejecuta el comando manualmente para probar:

openclaw agent --message 'Create my daily briefing for today. Include: weather summary, calendar events, and any important reminders.'

Esto debería activar la misma respuesta que tu automatización enviará. Revisa tu canal conectado para el mensaje.

Método B: Probar con Horario Corto

Para pruebas, puedes cambiar temporalmente el horario para que se ejecute más frecuentemente:

{
  "cron": {
    "jobs": [
      {
        "schedule": "*/5 * * * *",
        "command": "agent --message 'Test briefing'"
      }
    ]
  }
}

¡Recuerda cambiarlo de nuevo a tu horario deseado después de probar!

Verifica que tu automatización esté programada correctamente:

Revisar Registros del Gateway

Busca mensajes en tus registros del Gateway indicando que los trabajos cron están cargados:

# If running as service, check logs:
openclaw gateway logs

# Or check system logs (macOS):
log show --predicate 'process == "openclaw"' --last 5m

Esperar la Hora Programada

Si lo configuraste para ejecutarse a una hora específica, espera hasta esa hora y revisa tu canal para el mensaje automatizado.

Ejemplo 1: Resumen Semanal

{
  "cron": {
    "jobs": [
      {
        "schedule": "0 18 * * 5",
        "command": "agent --message 'Create a weekly summary of my accomplishments and tasks completed this week.'"
      }
    ]
  }
}

Se ejecuta cada viernes a las 6:00 PM.

Ejemplo 2: Verificación de Recordatorios

{
  "cron": {
    "jobs": [
      {
        "schedule": "0 8 * * *",
        "command": "agent --message 'Check my calendar and remind me of any important events or deadlines today.'"
      }
    ]
  }
}

Se ejecuta cada mañana a las 8:00 AM.

Ejemplo 3: Múltiples Automatizaciones

{
  "cron": {
    "jobs": [
      {
        "schedule": "0 9 * * *",
        "command": "agent --message 'Daily briefing'"
      },
      {
        "schedule": "0 18 * * *",
        "command": "agent --message 'Evening summary'"
      },
      {
        "schedule": "0 0 * * 1",
        "command": "agent --message 'Weekly planning session'"
      }
    ]
  }
}

Gestiona múltiples trabajos con diferentes horarios.

Solución de Problemas

La Automatización No Se Ejecuta

Si tu automatización no se ejecuta:

• Verifica la sintaxis cron: Asegúrate que el formato de horario sea correcto
• Verifica que el Gateway esté ejecutándose: openclaw gateway status
• Revisa el archivo de configuración: Asegúrate que el JSON sea válido (sin errores de sintaxis)
• Revisa los registros del Gateway: Busca mensajes de error sobre trabajos cron
• Reinicia el Gateway: A veces se necesita un reinicio para cargar nuevas automatizaciones

Zona Horaria Incorrecta

Los trabajos cron usan la zona horaria de tu sistema. Si las horas parecen incorrectas:

• Verifica la zona horaria de tu sistema: date
• Ajusta tu horario en consecuencia
• O establece una zona horaria específica en la configuración de tu sistema

El Comando No Se Ejecuta

Si el comando no se ejecuta:

• Prueba el comando manualmente primero (fuera de cron)
• Verifica que la sintaxis del comando del agente sea correcta
• Verifica que tu canal esté conectado (para la entrega de mensajes)

Ahora que entiendes los conceptos básicos de automatización, explora características avanzadas:

Mejores Prácticas

• Comienza Simple - Inicia con trabajos cron básicos antes de webhooks complejos
• Prueba Primero - Siempre prueba los comandos manualmente antes de automatizar
• Monitorea Registros - Mantén un ojo en los registros de ejecución de automatización
• Maneja Errores - Asegúrate que las automatizaciones manejen fallos elegantemente
• Ten en Cuenta los Límites de Tasa - No crees automatizaciones que alcancen límites de API
• Asegura los Webhooks - Si usas webhooks, agrega autenticación