docs(cli): document cron list/show --json status field

This commit is contained in:
Vincent Koc
2026-05-07 02:24:08 -07:00
parent 8e17910191
commit 45778c66f4

View File

@@ -220,6 +220,8 @@ openclaw cron runs --id <job-id> --limit 50
`openclaw cron list` shows all matching jobs by default. Pass `--agent <id>` to show only jobs whose effective normalized agent id matches; jobs without a stored agent id count as the configured default agent.
`cron list --json` and `cron show <job-id> --json` include a top-level `status` field on each job, computed from `enabled`, `state.runningAtMs`, and `state.lastRunStatus`. Values: `disabled`, `running`, `ok`, `error`, `skipped`, or `idle`. This mirrors the human-readable status column so external tooling can read job state without re-deriving it.
`cron runs` entries include delivery diagnostics with the intended cron target, the resolved target, message-tool sends, fallback use, and delivered state.
Agent and session retargeting: