docs(system event): document --session-key timing exception · openclaw/openclaw@8399ff8
Kaspre
·
2026-05-12
·
via Recent Commits to openclaw:main
| Original file line number | Diff line number | Diff line change |
|---|
@@ -38,6 +38,14 @@ the heartbeat immediately; `next-heartbeat` waits for the next scheduled tick.
|
38 | 38 | Pass `--session-key` to target a specific session (for example to relay an |
39 | 39 | async-task completion back to the channel that started it). |
40 | 40 | |
| 41 | +> **Timing exception with `--session-key`:** when `--session-key` is supplied, |
| 42 | +> `--mode next-heartbeat` collapses to an immediate targeted wake instead of |
| 43 | +> waiting for the next scheduled tick. Targeted wakes use heartbeat intent |
| 44 | +> `immediate` so they bypass the runner's not-due gate that would otherwise |
| 45 | +> defer (and effectively drop) an `event`-intent wake. If you want delayed |
| 46 | +> delivery, omit `--session-key` so the event lands on the main session and |
| 47 | +> rides the next regular heartbeat. |
| 48 | + |
41 | 49 | Flags: |
42 | 50 | |
43 | 51 | - `--text <text>`: required system event text. |
|
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。
