This change enables the heartbeat to run in a different session than main. This is important for clawdbot users who do not use the main session (e.g. the majority of my bot-to-human conversation happens within a discord channel).

Changes

• add new optional config heartbeat.session (default: main)
• example: { session: "agent:main:discord:channel:123", ... }
• when configured, the heartbeat will run in this session
• updated docs

Alternatives

A plugin could approximate this by injecting channel context into the heartbeat prompt via before_agent_start. But this belongs at the framework level: users who primarily work outside the main session would otherwise get heartbeats that miss recent conversation context.

Testing

• added unit tests
• live tested with my clawdbot that lives in a private Discord channel

👾 Assisted by Codex