@@ -232,42 +232,42 @@ Use `accountId` to target a specific account on multi-account channels like Tele
232232<ParamField path="session" type="string">
233233 Optional session key for heartbeat runs.
234234235-- `main` (default): agent main session.
236-- Explicit session key (copy from `openclaw sessions --json` or the [sessions CLI](/cli/sessions)).
237-- Session key formats: see [Sessions](/concepts/session) and [Groups](/channels/groups).
235+ - `main` (default): agent main session.
236+ - Explicit session key (copy from `openclaw sessions --json` or the [sessions CLI](/cli/sessions)).
237+ - Session key formats: see [Sessions](/concepts/session) and [Groups](/channels/groups).
238238</ParamField>
239- <ParamField path="target" type="string">
240-- `last`: deliver to the last used external channel.
241-- explicit channel: any configured channel or plugin id, for example `discord`, `matrix`, `telegram`, or `whatsapp`.
242-- `none` (default): run the heartbeat but **do not deliver** externally.
243- </ParamField>
244- <ParamField path="directPolicy" type='"allow" | "block"' default="allow">
239+<ParamField path="target" type="string">
240+ - `last`: deliver to the last used external channel.
241+ - explicit channel: any configured channel or plugin id, for example `discord`, `matrix`, `telegram`, or `whatsapp`.
242+ - `none` (default): run the heartbeat but **do not deliver** externally.
243+</ParamField>
244+<ParamField path="directPolicy" type='"allow" | "block"' default="allow">
245245 Controls direct/DM delivery behavior. `allow`: allow direct/DM heartbeat delivery. `block`: suppress direct/DM delivery (`reason=dm-blocked`).
246- </ParamField>
247- <ParamField path="to" type="string">
246+</ParamField>
247+<ParamField path="to" type="string">
248248 Optional recipient override (channel-specific id, e.g. E.164 for WhatsApp or a Telegram chat id). For Telegram topics/threads, use `<chatId>:topic:<messageThreadId>`.
249- </ParamField>
250- <ParamField path="accountId" type="string">
249+</ParamField>
250+<ParamField path="accountId" type="string">
251251 Optional account id for multi-account channels. When `target: "last"`, the account id applies to the resolved last channel if it supports accounts; otherwise it is ignored. If the account id does not match a configured account for the resolved channel, delivery is skipped.
252- </ParamField>
253- <ParamField path="prompt" type="string">
252+</ParamField>
253+<ParamField path="prompt" type="string">
254254 Overrides the default prompt body (not merged).
255- </ParamField>
256- <ParamField path="ackMaxChars" type="number" default="300">
255+</ParamField>
256+<ParamField path="ackMaxChars" type="number" default="300">
257257 Max chars allowed after `HEARTBEAT_OK` before delivery.
258- </ParamField>
259- <ParamField path="suppressToolErrorWarnings" type="boolean">
258+</ParamField>
259+<ParamField path="suppressToolErrorWarnings" type="boolean">
260260 When true, suppresses tool error warning payloads during heartbeat runs.
261- </ParamField>
262- <ParamField path="activeHours" type="object">
261+</ParamField>
262+<ParamField path="activeHours" type="object">
263263 Restricts heartbeat runs to a time window. Object with `start` (HH:MM, inclusive; use `00:00` for start-of-day), `end` (HH:MM exclusive; `24:00` allowed for end-of-day), and optional `timezone`.
264264265-- Omitted or `"user"`: uses your `agents.defaults.userTimezone` if set, otherwise falls back to the host system timezone.
266-- `"local"`: always uses the host system timezone.
267-- Any IANA identifier (e.g. `America/New_York`): used directly; if invalid, falls back to the `"user"` behavior above.
268-- `start` and `end` must not be equal for an active window; equal values are treated as zero-width (always outside the window).
269-- Outside the active window, heartbeats are skipped until the next tick inside the window.
270- </ParamField>
265+ - Omitted or `"user"`: uses your `agents.defaults.userTimezone` if set, otherwise falls back to the host system timezone.
266+ - `"local"`: always uses the host system timezone.
267+ - Any IANA identifier (e.g. `America/New_York`): used directly; if invalid, falls back to the `"user"` behavior above.
268+ - `start` and `end` must not be equal for an active window; equal values are treated as zero-width (always outside the window).
269+ - Outside the active window, heartbeats are skipped until the next tick inside the window.
270+</ParamField>
271271272272## Delivery behavior
273273此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。