openclaw - 💡(How to fix) Fix [Feature]: Support disabling heartbeat via config [1 comments, 2 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#70668Fetched 2026-04-24 05:54:56
View on GitHub
Comments
1
Participants
2
Timeline
2
Reactions
0
Author
Timeline (top)
commented ×1labeled ×1

Currently the heartbeat feature cannot be disabled via openclaw.json. Setting "heartbeat": false results in a config validation error and the Gateway falls back to the last-known-good config ("every": "30m").

Users who want to disable heartbeat entirely have no valid config value to do so.

Error Message

Setting "heartbeat": false results in a config validation error and the

  • Error observed: reload-invalid-config → config restored from backup

Root Cause

Currently the heartbeat feature cannot be disabled via openclaw.json. Setting "heartbeat": false results in a config validation error and the Gateway falls back to the last-known-good config ("every": "30m").

Users who want to disable heartbeat entirely have no valid config value to do so.

Fix Action

Fix / Workaround

As a temporary workaround, users can set an extremely large interval like "every": "9999h" but this is not intuitive.

RAW_BUFFERClick to expand / collapse

Summary

Currently the heartbeat feature cannot be disabled via openclaw.json. Setting "heartbeat": false results in a config validation error and the Gateway falls back to the last-known-good config ("every": "30m").

Users who want to disable heartbeat entirely have no valid config value to do so.

Problem to solve

Add a valid "disabled" config option, either:

  1. "heartbeat": null — interpret null as "disabled"
  2. "heartbeat": { "enabled": false } — explicit flag
  3. "heartbeat": "off" — string shorthand

Proposed solution

NO IDEA

Alternatives considered

NO IDEA

Impact

  • OpenClaw version: 2026.4.21
  • Platform: macOS (Darwin arm64)
  • Config schema currently only accepts heartbeat.every as string duration
  • Error observed: reload-invalid-config → config restored from backup

Evidence/examples

As a temporary workaround, users can set an extremely large interval like "every": "9999h" but this is not intuitive.

Additional information

NO

extent analysis

TL;DR

The heartbeat feature can be disabled by introducing a valid "disabled" config option, such as setting "heartbeat": null or adding an explicit flag.

Guidance

  • Introduce a new config option to explicitly disable the heartbeat feature, for example, by setting "heartbeat": null or using an object with an "enabled": false flag.
  • Update the config schema to accept the new "disabled" config option, ensuring backward compatibility with existing configurations.
  • Consider adding a string shorthand like "heartbeat": "off" for easier configuration.
  • Verify the fix by testing the new config option and ensuring the Gateway does not fall back to the last-known-good config.

Example

{
  "heartbeat": null
}

or

{
  "heartbeat": {
    "enabled": false
  }
}

Notes

The proposed solution should be tested thoroughly to ensure it does not introduce any unintended side effects or errors.

Recommendation

Apply workaround by introducing a new config option, as it provides a clear and explicit way to disable the heartbeat feature.

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 [Feature]: Support disabling heartbeat via config [1 comments, 2 participants]