openclaw - 💡(How to fix) Fix [Bug]: WebSocket handshake timeout when executing `openclaw cron list` [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#61554Fetched 2026-04-08 02:57:23
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants

Error Message

  1. Observe the error: "gateway connect failed: Error: gateway closed (1000)"

Code Example

{"subsystem":"gateway/ws","cause":"handshake-timeout","durationMs":8026,"handshakeMs":3001}
RAW_BUFFERClick to expand / collapse

Describe the bug Executing openclaw cron list fails with WebSocket handshake timeout after ~8 seconds, while the handshake timeout limit is set to 3 seconds.

Steps to reproduce

  1. Run openclaw gateway status to ensure the service is running
  2. Execute openclaw cron list
  3. Observe the error: "gateway connect failed: Error: gateway closed (1000)"

Screenshots/Logs

{"subsystem":"gateway/ws","cause":"handshake-timeout","durationMs":8026,"handshakeMs":3001}

Environment:

  • OpenClaw version: 2026.3.13
  • Node.js version: 24.14.1
  • OS: Linux 6.17.0-20-generic (x64)
  • Installation method: npm global

Additional context:

  • Plugins loaded: openclaw-qqbot (1.7.1), wecom-openclaw-plugin (2026.3.20)
  • Browser: Chrome 136+ with CDP on port 9222

Note: This issue is not related to plugin loading time, which is only 37ms. The handshake timeout occurs before plugin loading even starts.

extent analysis

TL;DR

The WebSocket handshake timeout issue may be resolved by adjusting the handshake timeout limit or investigating the cause of the delay in the gateway connection.

Guidance

  • Verify the handshake timeout limit configuration to ensure it is set correctly to 3 seconds, and consider increasing this value if the gateway connection requires more time.
  • Investigate the gateway connection process to identify the cause of the delay, as the handshake timeout occurs before plugin loading starts.
  • Check the system resources and network connectivity to ensure they are not contributing to the delay in the gateway connection.
  • Review the logs and system metrics to see if there are any other errors or issues that may be related to the handshake timeout.

Example

No code snippet is provided as the issue does not imply a specific code change.

Notes

The root cause of the issue is unclear, and further investigation is needed to determine the exact cause of the delay in the gateway connection. The provided logs and system information may not be sufficient to identify the issue.

Recommendation

Apply workaround: Adjust the handshake timeout limit to a higher value, such as 10 seconds, to see if it resolves the issue. This is recommended because the current timeout limit of 3 seconds may be too low, causing the handshake to timeout prematurely.

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