openclaw - 💡(How to fix) Fix Feature Request: Configurable streaming watchdog timeout threshold [4 comments, 5 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#68596Fetched 2026-04-19 15:09:48
View on GitHub
Comments
4
Participants
5
Timeline
5
Reactions
4
Timeline (top)
commented ×4subscribed ×1

Fix Action

Fix / Workaround

  1. No server-side mitigation available: Despite configuring:
    • agents.defaults.timeoutSeconds: 1200 (20 min agent timeout)
    • reasoningDefault: "stream" (stream reasoning output)
    • blockStreamingChunk.minChars: 20 (more frequent chunking)

Current Workarounds (Limited Effectiveness)

Code Example

streaming watchdog: no stream updates for 30s; resetting status. 
The backend may have dropped this run silently — send a new message to resync.

---

{
  "gateway": {
    "streamingWatchdog": {
      "noOutputTimeoutMs": 60000,  // configurable threshold, default 30000
      "enabled": true               // allow disabling for trusted setups
    }
  }
}

---

{
  "acp": {
    "stream": {
      "watchdogNoOutputMs": 60000
    }
  }
}
RAW_BUFFERClick to expand / collapse

Problem Description

When using models that perform extended reasoning/thinking (e.g., kimi-k2.5, DeepSeek-R1), the streaming watchdog frequently triggers warnings:

streaming watchdog: no stream updates for 30s; resetting status. 
The backend may have dropped this run silently — send a new message to resync.

This 30-second threshold appears to be hardcoded in the client UI and cannot be configured server-side.

Impact

  1. False positives during legitimate reasoning: Models like kimi-k2.5 may legitimately spend 30-60+ seconds in deep thinking phases before producing output. The watchdog warning creates unnecessary alarm for users.

  2. User experience disruption: The warning message implies something went wrong, prompting users to "resync" by sending new messages, which can:

    • Interrupt ongoing reasoning processes
    • Cause duplicate queries
    • Break conversation context
  3. No server-side mitigation available: Despite configuring:

    • agents.defaults.timeoutSeconds: 1200 (20 min agent timeout)
    • reasoningDefault: "stream" (stream reasoning output)
    • blockStreamingChunk.minChars: 20 (more frequent chunking)

    The 30-second client watchdog still triggers independently.

Proposed Solution

Add a configurable streaming watchdog timeout in openclaw.json:

{
  "gateway": {
    "streamingWatchdog": {
      "noOutputTimeoutMs": 60000,  // configurable threshold, default 30000
      "enabled": true               // allow disabling for trusted setups
    }
  }
}

Alternatively, expose this via ACP stream configuration:

{
  "acp": {
    "stream": {
      "watchdogNoOutputMs": 60000
    }
  }
}

Use Cases

  1. Extended reasoning models: Users deploying models with long thinking phases (30-120 seconds) can adjust thresholds appropriately.

  2. Local/trusted setups: For personal assistant deployments on loopback-only gateways, users may prefer longer thresholds or disabling the watchdog entirely.

  3. Network-aware configuration: Users with known network latency characteristics can tune thresholds based on their environment.

Current Workarounds (Limited Effectiveness)

  • reasoningDefault: "stream" — Helps but requires models to emit reasoning tokens
  • blockStreamingChunk.minChars — More frequent chunks but doesn't prevent legitimate thinking silence
  • No actual watchdog timeout configuration exists

Related

The acp.stream.coalesceIdleMs parameter exists but controls text block coalescing, not the watchdog timeout mechanism.


Thank you for considering this feature request. A configurable watchdog threshold would significantly improve the experience for users working with reasoning-capable models.

extent analysis

TL;DR

Implementing a configurable streaming watchdog timeout in the client UI or server-side configuration would likely resolve the issue of false positives during legitimate reasoning phases.

Guidance

  • Review the proposed solution to add a configurable streaming watchdog timeout in openclaw.json or expose it via ACP stream configuration to determine the best approach for your use case.
  • Consider the trade-offs between setting a longer threshold, disabling the watchdog, or implementing a network-aware configuration based on your specific environment and model requirements.
  • Evaluate the current workarounds, such as reasoningDefault: "stream" and blockStreamingChunk.minChars, to understand their limitations and potential impact on your use case.
  • Investigate the relationship between the acp.stream.coalesceIdleMs parameter and the watchdog timeout mechanism to ensure a comprehensive understanding of the configuration options.

Example

No code snippet is provided as the issue focuses on configuration and feature request rather than a specific code implementation.

Notes

The solution requires changes to the client UI or server-side configuration, and the proposed approach may have implications for user experience, model performance, and network characteristics. The effectiveness of the current workarounds is limited, and a configurable watchdog threshold would provide more flexibility and control.

Recommendation

Apply a workaround by adjusting the reasoningDefault and blockStreamingChunk.minChars configurations to mitigate the issue, while awaiting the implementation of a configurable streaming watchdog timeout. This approach allows for some improvement in the user experience while a more comprehensive solution is developed.

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