openclaw - 💡(How to fix) Fix Add config option to hide heartbeat poll messages in webchat UI [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openclaw/openclaw#49374Fetched 2026-04-08 00:55:52
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Participants
Timeline (top)
labeled ×1

Heartbeat poll messages are displayed in webchat UI and disrupt conversation; need a config to hide them.

Root Cause

Heartbeat poll messages are displayed in webchat UI and disrupt conversation; need a config to hide them.

RAW_BUFFERClick to expand / collapse

Summary

Heartbeat poll messages are displayed in webchat UI and disrupt conversation; need a config to hide them.

Problem to solve

When using the webchat UI (Control UI chat tab), the heartbeat poll messages are shown to users in the conversation: Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK. This appears every 5-30 minutes (depending on heartbeat interval config) and disrupts the conversation experience.

Proposed solution

<webchat> Provide an option to hide heartbeat poll messages in webchat UI, similar to the existing showOk and showAlerts config for heartbeat responses.

Option 1: Add a config option like channels.defaults.heartbeat.showPoll: false Option 2: Filter messages in webchat UI that match the heartbeat poll pattern (e.g., start with "Read HEARTBEAT.md")

Alternatives considered

Manual prefixing in prompts is inconsistent and hard to enforce.

• Increasing heartbeat interval reduces frequency but defeats frequent check purpose.

• Using other channels avoids the issue but limits webchat usage.

Impact

• Affected users/systems/channels: All webchat UI users, Control UI chat tab

• Severity: Annoying, disrupts conversation flow

• Frequency: Intermittent (every 5–30 minutes)

• Consequence: Distracts users, pollutes message history, reduces conversation clarity

Evidence/examples

Current heartbeat config only controls responses, not poll messages: { "channels": { "defaults": { "heartbeat": { "showOk": false, "showAlerts": false, "useIndicator": true } } } }

<img width="522" height="228" alt="Image" src="https://github.com/user-attachments/assets/9a464047-388e-4e9e-bcfa-0bc7783dea16" />

Additional information

No response

extent analysis

Fix Plan

To hide heartbeat poll messages in the webchat UI, we will implement a configuration option to filter out these messages.

Step-by-Step Solution:

  1. Add a new configuration option: Introduce a showPoll property under channels.defaults.heartbeat to control the visibility of heartbeat poll messages.
  2. Update webchat UI to respect the new config: Modify the webchat UI code to check the showPoll config and filter out heartbeat poll messages if set to false.
  3. Default behavior: Set the default value of showPoll to false to hide heartbeat poll messages by default.

Example Code:

// Configuration update
const config = {
  "channels": {
    "defaults": {
      "heartbeat": {
        "showOk": false,
        "showAlerts": false,
        "useIndicator": true,
        "showPoll": false // New config option
      }
    }
  }
};

// Webchat UI code update
if (!config.channels.defaults.heartbeat.showPoll) {
  // Filter out heartbeat poll messages
  const isHeartbeatPoll = message.startsWith("Read HEARTBEAT.md");
  if (isHeartbeatPoll) {
    return; // Skip rendering the message
  }
}

Verification

To verify the fix, follow these steps:

  • Update the configuration with showPoll set to false.
  • Open the webchat UI and initiate a conversation.
  • Wait for the heartbeat poll message to be sent (based on the configured interval).
  • Verify that the heartbeat poll message is not displayed in the conversation.

Extra Tips

  • Ensure that the showPoll config is properly documented and exposed to users.
  • Consider adding a similar config option for other channels to maintain consistency.
  • Review the conversation flow and user experience to identify any other potential disruptions.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix Add config option to hide heartbeat poll messages in webchat UI [1 participants]