Naar hoofdinhoud gaan

​
Problemen oplossen bij automatisering

Gebruik deze pagina voor problemen met planning en bezorging (cron + heartbeat).

​
Opdrachtenladder

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Voer daarna automatiseringscontroles uit: 
openclaw cron status
openclaw cron list
openclaw system heartbeat last

​
Cron start niet

openclaw cron status
openclaw cron list
openclaw cron runs --id <jobId> --limit 20
openclaw logs --follow
Goede uitvoer ziet er zo uit:
  • cron status meldt ingeschakeld en een toekomstige nextWakeAtMs.
  • De job is ingeschakeld en heeft een geldig schema/tijdzone.
  • cron runs toont ok of een expliciete reden voor overslaan.
Veelvoorkomende signalen:
  • cron: scheduler disabled; jobs will not run automatically → cron uitgeschakeld in config/omgeving.
  • cron: timer tick failed → scheduler-tick gecrasht; inspecteer omliggende stack-/logcontext.
  • reason: not-due in uitvoer van een run → handmatige run aangeroepen zonder --force en de job is nog niet aan de beurt.

​
Cron uitgevoerd maar geen bezorging

openclaw cron runs --id <jobId> --limit 20
openclaw cron list
openclaw channels status --probe
openclaw logs --follow
Goede uitvoer ziet er zo uit:
  • Runstatus is ok.
  • Bezorgmodus/doel zijn ingesteld voor geïsoleerde jobs.
  • Kanaalprobe meldt dat het doelkanaal is verbonden.
Veelvoorkomende signalen:
  • Run geslaagd maar bezorgmodus is none → er wordt geen extern bericht verwacht.
  • Bezorgdoel ontbreekt/ongeldig (channel/to) → run kan intern slagen maar uitgaande bezorging overslaan.
  • Kanaalautorisatiefouten (unauthorized, missing_scope, Forbidden) → bezorging geblokkeerd door kanaalreferenties/rechten.

​
Heartbeat onderdrukt of overgeslagen

openclaw system heartbeat last
openclaw logs --follow
openclaw config get agents.defaults.heartbeat
openclaw channels status --probe
Goede uitvoer ziet er zo uit:
  • Heartbeat ingeschakeld met een niet-nul interval.
  • Laatste heartbeatresultaat is ran (of de reden voor overslaan is bekend).
Veelvoorkomende signalen:
  • heartbeat skipped met reason=quiet-hours → buiten activeHours.
  • requests-in-flight → hoofdlane bezig; heartbeat uitgesteld.
  • empty-heartbeat-file → HEARTBEAT.md bestaat maar bevat geen actiegerichte inhoud.
  • alerts-disabled → zichtbaarheidsinstellingen onderdrukken uitgaande heartbeatberichten.

​
Valkuilen met tijdzone en 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
Snelle regels:
  • Config path not found: agents.defaults.userTimezone betekent dat de sleutel niet is ingesteld; heartbeat valt terug op de hosttijdzone (of activeHours.timezone indien ingesteld).
  • Cron zonder --tz gebruikt de tijdzone van de Gateway-host.
  • Heartbeat activeHours gebruikt de geconfigureerde tijdzone-resolutie (user, local of expliciete IANA-tz).
  • ISO-tijdstempels zonder tijdzone worden voor cron-at-schema’s behandeld als UTC.
Veelvoorkomende signalen:
  • Jobs draaien op het verkeerde kloktijdstip na wijzigingen aan de hosttijdzone.
  • Heartbeat wordt overdag altijd overgeslagen omdat activeHours.timezone onjuist is.
Gerelateerd: