Skip to content

feat(heartbeat): add configurable visibility for heartbeat responses#1452

Merged
steipete merged 2 commits intoopenclaw:mainfrom
dlauer:feature/silent-heartbeat-visibility
Jan 24, 2026
Merged

feat(heartbeat): add configurable visibility for heartbeat responses#1452
steipete merged 2 commits intoopenclaw:mainfrom
dlauer:feature/silent-heartbeat-visibility

Conversation

@dlauer
Copy link
Copy Markdown
Contributor

@dlauer dlauer commented Jan 22, 2026

Summary

Add per-channel and per-account heartbeat visibility settings to control when heartbeat messages are shown.

Changes

  • New: heartbeat-visibility.ts - resolver for visibility settings
  • New: heartbeat-visibility.test.ts - 10 unit tests
  • Modified: Channel config types to include heartbeat visibility options
  • Modified: Heartbeat runner to respect visibility settings

Config Options

channels:
  defaults:
    heartbeat:
      showOk: false      # Hide HEARTBEAT_OK (default)
      showAlerts: true   # Show alert messages (default)
      useIndicator: true # Emit typing indicator (default)
  telegram:
    heartbeat:
      showOk: true  # Override per-channel

Precedence

per-account > per-channel > channel-defaults > global defaults

Why

Routine HEARTBEAT_OK messages can clutter chat history. This allows silencing them while still surfacing alerts when something needs attention.

@czekaj
Copy link
Copy Markdown
Contributor

czekaj commented Jan 23, 2026

Yeah, it's cluttering the web ui chat and the MacOS app chat right now.

dlauer and others added 2 commits January 24, 2026 09:02
Add per-channel and per-account heartbeat visibility settings:
- showOk: hide/show HEARTBEAT_OK messages (default: false)
- showAlerts: hide/show alert messages (default: true)
- useIndicator: emit typing indicator events (default: true)

Config precedence: per-account > per-channel > channel-defaults > global

This allows silencing routine heartbeat acks while still surfacing
alerts when something needs attention.
@steipete steipete force-pushed the feature/silent-heartbeat-visibility branch from 8a9e078 to c2dbce6 Compare January 24, 2026 09:06
@steipete steipete merged commit 7b76db2 into openclaw:main Jan 24, 2026
20 of 22 checks passed
@steipete
Copy link
Copy Markdown
Contributor

Landed via temp rebase onto main.\n\n- Gate: pnpm lint && pnpm build && pnpm test\n- Land commit: 7b76db2\n- Merge commit: 7b76db2\n\nThanks @dlauer!

zooqueen pushed a commit to hanzoai/bot that referenced this pull request Mar 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants