Passer au contenu principal

​
Dépannage de l’automatisation

Utilisez cette page pour les problèmes de planification et de livraison (cron + heartbeat).

​
Échelle de commandes

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Ensuite, exécutez les vérifications d’automatisation : 
openclaw cron status
openclaw cron list
openclaw system heartbeat last

​
Cron ne se déclenche pas

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow
Une sortie correcte ressemble à :
  • cron status indique activé et un futur nextWakeAtMs.
  • La tâche est activée et possède une planification/un fuseau horaire valides.
  • cron runs affiche ok ou une raison explicite de saut.
Signatures courantes :
  • cron: scheduler disabled; jobs will not run automatically → cron désactivé dans la configuration/les variables d’environnement.
  • cron: timer tick failed → le tick du planificateur a planté ; inspectez le contexte de pile/logs environnant.
  • reason: not-due dans la sortie d’exécution → exécution manuelle appelée sans --force et la tâche n’est pas encore due.

​
Cron déclenché mais aucune livraison

openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow
Une sortie correcte ressemble à :
  • Le statut d’exécution est ok.
  • Le mode/la cible de livraison sont définis pour les tâches isolées.
  • La sonde de canal indique que le canal cible est connecté.
Signatures courantes :
  • L’exécution a réussi mais le mode de livraison est none → aucun message externe n’est attendu.
  • Cible de livraison manquante/invalide (channel/to) → l’exécution peut réussir en interne mais ignorer la sortie.
  • Erreurs d’authentification du canal (unauthorized, missing_scope, Forbidden) → livraison bloquée par les identifiants/permissions du canal.

​
Heartbeat supprimé ou ignoré

openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe
Une sortie correcte ressemble à :
  • Heartbeat activé avec un intervalle non nul.
  • Le dernier résultat de heartbeat est ran (ou la raison du saut est comprise).
Signatures courantes :
  • heartbeat skipped avec reason=quiet-hours → en dehors de activeHours.
  • requests-in-flight → la voie principale est occupée ; heartbeat différé.
  • empty-heartbeat-file → HEARTBEAT.md existe mais n’a aucun contenu exploitable.
  • alerts-disabled → les paramètres de visibilité suppriment les messages de heartbeat sortants.

​
Pièges liés au fuseau horaire et à activeHours

openclaw config get agents.defaults.heartbeat.activeHours
openclaw config get agents.defaults.heartbeat.activeHours.timezone
openclaw config get agents.defaults.userTimezone || echo "agents.defaults.userTimezone not set"
openclaw cron list
openclaw logs --follow
Règles rapides :
  • Config path not found: agents.defaults.userTimezone signifie que la clé n’est pas définie ; le heartbeat revient au fuseau horaire de l’hôte (ou activeHours.timezone s’il est défini).
  • Un cron sans --tz utilise le fuseau horaire de l’hôte de la Gateway (passerelle).
  • Le heartbeat activeHours utilise la résolution de fuseau horaire configurée (user, local ou un fuseau IANA explicite).
  • Les horodatages ISO sans fuseau horaire sont traités comme UTC pour les planifications cron at.
Signatures courantes :
  • Les tâches s’exécutent à une heure civile incorrecte après des changements de fuseau horaire de l’hôte.
  • Le heartbeat est toujours ignoré pendant votre journée parce que activeHours.timezone est incorrect.
Liens connexes :