openclaw - 💡(How to fix) Fix Bug: agentTurn cron jobs crash on sourceReplyDeliveryMode (v2026.5.22)

Bug: agentTurn cron jobs crash with TypeError: Cannot read properties of undefined (reading 'sourceReplyDeliveryMode')

Version

OpenClaw 2026.5.22 (a374c3a)

Description

All cron jobs with payload.kind: "agentTurn" crash during session bootstrap with:

TypeError: Cannot read properties of undefined (reading 'sourceReplyDeliveryMode')

The error occurs at the agent-run level before any agent code executes.

Reproduction

1. Create any cron job with payload.kind: "agentTurn"
2. Trigger it (manually or via schedule)
3. Job fails immediately (~7s) with the above error

Tested session targets — all fail identically:

• sessionTarget: "isolated" (default for agentTurn)
• sessionTarget: "session:<custom-id>"
• delivery.mode: "announce" with explicit channel, to, accountId
• delivery.mode: "none"

Root cause (from source inspection)

The crash appears to be in acp-runtime-backend where event.sourceReplyDeliveryMode is read from the bootstrap event. For cron-triggered agent turns, the event object (or a parent) is undefined because there's no inbound message context to derive sourceReplyDeliveryMode from.

Relevant code path in acp-runtime-backend-BPQA8n2I.js:34:

sourceReplyDeliveryMode: event.sourceReplyDeliveryMode,

Workaround

Using payload.kind: "systemEvent" with sessionTarget: "main" works — system events inject into the main session and get processed on heartbeat/wake. But this doesn't support isolated task runs, which is the primary use case for agentTurn cron jobs.

Expected behavior

agentTurn cron jobs should run successfully, with sourceReplyDeliveryMode defaulting to a safe value (e.g., undefined or "normal") when no inbound message context exists.