openclaw - 💡(How to fix) Fix [Feature]: WhatsApp web idle watchdog should be configurable (30m no-message reconnect) [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#70608Fetched 2026-04-24 05:55:47
View on GitHub
Comments
0
Participants
1
Timeline
1
Reactions
0
Author
Participants
Timeline (top)
labeled ×1

The WhatsApp web runtime currently forces a reconnect after ~30 minutes with no inbound messages:

No messages received in 30m - restarting connection

This seems to be a fixed idle watchdog, not a user-configurable setting.

Root Cause

For low-traffic deployments, "no inbound messages for 30m" is normal and should not automatically imply a stale connection. This creates false-positive reconnect churn and breaks monitoring pipelines that rely on connection continuity.

Code Example

### Summary

The WhatsApp web runtime currently forces a reconnect after ~30 minutes with no inbound messages:

`No messages received in 30m - restarting connection`

This seems to be a fixed idle watchdog, not a user-configurable setting.

### Environment

- OpenClaw 2026.4.21
- WhatsApp web runtime
- 8GB VPS
- 12-14 WhatsApp groups
- `requireMention: true`
- `groupPolicy: "allowlist"`

### Actual behavior

During quiet periods (overnight / early morning), the runtime reconnects every ~30 minutes even when nothing is wrong.

Effects:
- per-connection counters like `messagesHandled` reset to `0`
- `connectionId` changes every cycle
- log-based monitoring/reporting becomes discontinuous
- reconnect does not appear to fully rehydrate missed group history for auto-reply context

### Expected behavior

Please expose the idle watchdog as a config value, or allow disabling it. Something alongside the existing WhatsApp `web.*` runtime settings would help:
- configurable idle timeout
- optional disable switch
- possibly account-scoped override

### Why this matters

For low-traffic deployments, "no inbound messages for 30m" is normal and should not automatically imply a stale connection. This creates false-positive reconnect churn and breaks monitoring pipelines that rely on connection continuity.

### Extra context

We initially thought this was related to a group-delivery issue, but that turned out to be separate OOM pressure. After increasing Node heap (`--max-old-space-size=4096`), the runtime became stable, and the remaining issue is this 30-minute idle reconnect behavior during quiet periods.

Happy to test a PR on our setup.
RAW_BUFFERClick to expand / collapse

Summary

### Summary

The WhatsApp web runtime currently forces a reconnect after ~30 minutes with no inbound messages:

`No messages received in 30m - restarting connection`

This seems to be a fixed idle watchdog, not a user-configurable setting.

### Environment

- OpenClaw 2026.4.21
- WhatsApp web runtime
- 8GB VPS
- 12-14 WhatsApp groups
- `requireMention: true`
- `groupPolicy: "allowlist"`

### Actual behavior

During quiet periods (overnight / early morning), the runtime reconnects every ~30 minutes even when nothing is wrong.

Effects:
- per-connection counters like `messagesHandled` reset to `0`
- `connectionId` changes every cycle
- log-based monitoring/reporting becomes discontinuous
- reconnect does not appear to fully rehydrate missed group history for auto-reply context

### Expected behavior

Please expose the idle watchdog as a config value, or allow disabling it. Something alongside the existing WhatsApp `web.*` runtime settings would help:
- configurable idle timeout
- optional disable switch
- possibly account-scoped override

### Why this matters

For low-traffic deployments, "no inbound messages for 30m" is normal and should not automatically imply a stale connection. This creates false-positive reconnect churn and breaks monitoring pipelines that rely on connection continuity.

### Extra context

We initially thought this was related to a group-delivery issue, but that turned out to be separate OOM pressure. After increasing Node heap (`--max-old-space-size=4096`), the runtime became stable, and the remaining issue is this 30-minute idle reconnect behavior during quiet periods.

Happy to test a PR on our setup.

Problem to solve

During quiet periods, the WhatsApp runtime reconnects every 30 minutes with no way to configure this behavior.

Proposed solution

Add a configurable idle timeout to the WhatsApp web.* runtime settings, such as web.idleTimeoutMinutes or a disable switch.


### Alternatives considered

_No response_

### Impact

Hardcoding a longer reconnect interval externally, but this is not exposed as a config option either.

### Evidence/examples

_No response_

### Additional information

_No response_

extent analysis

TL;DR

The most likely fix is to add a configurable idle timeout to the WhatsApp web runtime settings to prevent automatic reconnects during quiet periods.

Guidance

  • Review the existing WhatsApp web runtime settings to determine if there are any undocumented or hidden configuration options that could be used to adjust the idle timeout.
  • Consider implementing a custom solution to override the default idle timeout behavior, such as using a wrapper script or a custom plugin.
  • Evaluate the feasibility of modifying the OpenClaw codebase to expose the idle watchdog as a configurable setting.
  • Test the proposed solution of adding a web.idleTimeoutMinutes setting or a disable switch to the WhatsApp web runtime settings.

Example

No code snippet is provided as the issue does not contain sufficient technical details to create a concrete example.

Notes

The solution may require modifications to the OpenClaw codebase or the WhatsApp web runtime settings, which could have unintended consequences or compatibility issues.

Recommendation

Apply a workaround by modifying the OpenClaw codebase to expose the idle watchdog as a configurable setting, as this would provide a more flexible and sustainable solution than hardcoding a longer reconnect interval.

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…

FAQ

Expected behavior

Please expose the idle watchdog as a config value, or allow disabling it. Something alongside the existing WhatsApp web.* runtime settings would help:

  • configurable idle timeout
  • optional disable switch
  • possibly account-scoped override

Still need to ship something?

×6

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

Back to top recommendations

TRENDING