From 5ac1beae6842a784a34babfe82b00cab7fd237b2 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sun, 12 Apr 2026 04:24:32 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@3be7e3bde09783e24dda278639ea5aa12942449f --- .openclaw-sync/source.json | 4 ++-- docs/automation/cron-jobs.md | 12 ++++++++++++ 2 files changed, 14 insertions(+), 2 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index ecd03342f..462fa1f0a 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "3d1135fa195080ec284db12ee1b3aa88ce75fda2", - "syncedAt": "2026-04-12T04:22:39.108Z" + "sha": "3be7e3bde09783e24dda278639ea5aa12942449f", + "syncedAt": "2026-04-12T04:24:31.742Z" } diff --git a/docs/automation/cron-jobs.md b/docs/automation/cron-jobs.md index f71d568e5..45c59006a 100644 --- a/docs/automation/cron-jobs.md +++ b/docs/automation/cron-jobs.md @@ -62,6 +62,18 @@ Timestamps without a timezone are treated as UTC. Add `--tz America/New_York` fo Recurring top-of-hour expressions are automatically staggered by up to 5 minutes to reduce load spikes. Use `--exact` to force precise timing or `--stagger 30s` for an explicit window. +### Day-of-month and day-of-week use OR logic + +Cron expressions are parsed by [croner](https://github.com/Hexagon/croner). When both the day-of-month and day-of-week fields are non-wildcard, croner matches when **either** field matches — not both. This is standard Vixie cron behavior. + +``` +# Intended: "9 AM on the 15th, only if it's a Monday" +# Actual: "9 AM on every 15th, AND 9 AM on every Monday" +0 9 15 * 1 +``` + +This fires ~5–6 times per month instead of 0–1 times per month. OpenClaw uses Croner's default OR behavior here. To require both conditions, use Croner's `+` day-of-week modifier (`0 9 15 * +1`) or schedule on one field and guard the other in your job's prompt or command. + ## Execution styles | Style | `--session` value | Runs in | Best for |