Tâches Cron Clawdbot

Planifiez des tâches automatisées avec les tâches cron de l'assistant IA Clawdbot. Apprenez à configurer des messages récurrents, des rapports et des workflows automatisés.

Aperçu des tâches Cron Clawdbot

Clawdbot prend en charge les tâches planifiées en utilisant la syntaxe de style cron. Les tâches cron permettent des messages automatisés, des rapports périodiques, des vérifications de santé et des workflows récurrents.

Configuration

Tâche Cron de base

{
  "cron": {
    "jobs": [
      {
        "id": "daily-summary",
        "schedule": "0 9 * * *",
        "action": "send_message",
        "target": {
          "channel": "whatsapp",
          "peer": "+15551234567"
        },
        "message": "Good morning! Here's your daily summary."
      }
    ]
  }
}

Syntaxe Cron

ChampValeursDescription
Minute0-59Minute de l'heure
Heure0-23Heure du jour
Jour1-31Jour du mois
Mois1-12Mois de l'année
Jour de la semaine0-6Jour de la semaine (0=Dimanche)

Planifications courantes

PlanificationExpression Cron
Toutes les heures0 * * * *
Quotidien à 9h0 9 * * *
Hebdomadaire lundi0 9 * * 1
Mensuel le 1er0 9 1 * *

Types de tâches

Tâches de messages

Envoyer des messages planifiés :

{
  "id": "reminder",
  "schedule": "0 8 * * 1-5",
  "action": "send_message",
  "target": {
    "channel": "telegram",
    "peer": "123456789"
  },
  "message": "Start of workday reminder!"
}

Tâches d'agent

Exécuter des tâches d'agent :

{
  "id": "daily-report",
  "schedule": "0 18 * * *",
  "action": "run_agent",
  "agentId": "reporter",
  "prompt": "Generate today's activity report"
}

Tâches Webhook

Déclencher des webhooks :

{
  "id": "health-check",
  "schedule": "*/5 * * * *",
  "action": "webhook",
  "url": "https://api.example.com/health",
  "method": "POST"
}

Gestion des sessions

Clés de session Cron

Les tâches cron utilisent des sessions dédiées :

cron:<job.id>

Isolation des sessions

  • Chaque tâche a sa propre session
  • L'historique persiste entre les exécutions
  • Le contexte est conservé

Gestion des tâches

Commandes CLI

# Lister les tâches cron
clawdbot cron list

# Ajouter une tâche
clawdbot cron add --id daily --schedule "0 9 * * *" --action send_message

# Supprimer une tâche
clawdbot cron remove daily

# Exécuter la tâche immédiatement
clawdbot cron run daily

État de la tâche

ÉtatDescription
activeLa tâche est planifiée
pausedLa tâche est en pause
runningEn cours d'exécution
failedLa dernière exécution a échoué

Gestion des erreurs

Politique de réessai

{
  "cron": {
    "retry": {
      "maxAttempts": 3,
      "backoff": "exponential",
      "initialDelay": 1000
    }
  }
}

Notifications d'échec

{
  "cron": {
    "notifications": {
      "onFailure": {
        "channel": "telegram",
        "peer": "admin_id"
      }
    }
  }
}

Fuseau horaire

Configuration

{
  "cron": {
    "timezone": "Asia/Shanghai"
  }
}

Comportement par défaut

  • Utilise le fuseau horaire du système si non spécifié
  • Toutes les planifications sont interprétées dans le fuseau horaire configuré

Exemples

Rappel de standup quotidien

{
  "id": "standup",
  "schedule": "0 9 * * 1-5",
  "action": "send_message",
  "target": {
    "channel": "discord",
    "peer": { "kind": "group", "id": "standup-channel" }
  },
  "message": "Time for daily standup! What did you work on yesterday?"
}

Rapport hebdomadaire

{
  "id": "weekly-report",
  "schedule": "0 17 * * 5",
  "action": "run_agent",
  "agentId": "main",
  "prompt": "Generate weekly summary report and send to team channel"
}

Prochaines étapes