openclaw/docs/gateway
lsh411 a42e3cb78a
feat(heartbeat): add accountId config option for multi-agent routing (#8702)
* feat(heartbeat): add accountId config option for multi-agent routing

Add optional accountId field to heartbeat configuration, allowing
multi-agent setups to explicitly specify which Telegram account
should be used for heartbeat delivery.

Previously, heartbeat delivery would use the accountId from the
session's deliveryContext. When a session had no prior conversation
history, heartbeats would default to the first/primary account
instead of the agent's intended bot.

Changes:
- Add accountId to HeartbeatSchema (zod-schema.agent-runtime.ts)
- Use heartbeat.accountId with fallback to session accountId (targets.ts)

Backward compatible: if accountId is not specified, behavior is unchanged.

Closes #8695

* fix: improve heartbeat accountId routing (#8702) (thanks @lsh411)

* fix: harden heartbeat accountId routing (#8702) (thanks @lsh411)

* fix: expose heartbeat accountId in status (#8702) (thanks @lsh411)

* chore: format status + heartbeat tests (#8702) (thanks @lsh411)

---------

Co-authored-by: m1 16 512 <m116512@m1ui-MacBookAir-2.local>
Co-authored-by: Gustavo Madeira Santana <gumadeiras@gmail.com>
2026-02-04 16:49:12 -05:00
..
security docs: document secure DM mode preset (#7872) 2026-02-04 06:55:13 +00:00
authentication.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
background-process.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
bonjour.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
bridge-protocol.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
cli-backends.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
configuration-examples.md docs: document secure DM mode preset (#7872) 2026-02-04 06:55:13 +00:00
configuration.md feat: per-channel responsePrefix override (#9001) 2026-02-04 16:16:34 -05:00
discovery.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
doctor.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
gateway-lock.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
health.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
heartbeat.md feat(heartbeat): add accountId config option for multi-agent routing (#8702) 2026-02-04 16:49:12 -05:00
index.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
local-models.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
logging.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
multiple-gateways.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
network-model.md Docs: landing page revamp (#8885) 2026-02-04 10:37:14 -05:00
openai-http-api.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
openresponses-http-api.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
pairing.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
protocol.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
remote-gateway-readme.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
remote.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
sandbox-vs-tool-policy-vs-elevated.md chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
sandboxing.md chore: Run `pnpm format:fix`. 2026-01-31 21:13:13 +09:00
tailscale.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
tools-invoke-http-api.md Docs: add nav titles across docs (#5689) 2026-01-31 15:04:03 -06:00
troubleshooting.md fix(docs): use canonical openclaw.ai domain instead of openclaw.bot 2026-01-31 20:34:51 -05:00