docs(cron): add subagent announce retry troubleshooting section

This commit is contained in:
Marcus Widing
2026-02-16 20:51:44 +01:00
committed by Peter Steinberger
parent 348ea6be96
commit a03098ca49

View File

@@ -503,3 +503,10 @@ openclaw system event --mode now --text "Next heartbeat: check battery."
- For forum topics, use `-100…:topic:<id>` so its explicit and unambiguous.
- If you see `telegram:...` prefixes in logs or stored “last route” targets, thats normal;
cron delivery accepts them and still parses topic IDs correctly.
### Subagent announce delivery retries
- When a subagent run completes, the gateway announces the result to the requester session.
- If the announce flow returns `false` (e.g. requester session is busy), the gateway retries up to 3 times with tracking via `announceRetryCount`.
- Announces older than 5 minutes past `endedAt` are force-expired to prevent stale entries from looping indefinitely.
- If you see repeated announce deliveries in logs, check the subagent registry for entries with high `announceRetryCount` values.