openclaw - 💡(How to fix) Fix bug(gateway): repeated SIGTERM-driven restarts make the gateway look crash-looped [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#63020Fetched 2026-04-09 07:59:26
View on GitHub
Comments
1
Participants
2
Timeline
1
Reactions
1
Timeline (top)
commented ×1

The gateway appears to enter a restart loop in local macOS operation, but the restart is not caused by a process crash. The logs show repeated SIGTERM-driven shutdowns followed by clean restarts.

Error Message

From the outside this feels like "gateway keeps dying", but the underlying cause is likely config/UI/reload churn rather than an internal fatal exception. That makes debugging much harder and can also break channel login flows while a user is trying to relink WhatsApp.

Root Cause

From the outside this feels like "gateway keeps dying", but the underlying cause is likely config/UI/reload churn rather than an internal fatal exception. That makes debugging much harder and can also break channel login flows while a user is trying to relink WhatsApp.

RAW_BUFFERClick to expand / collapse

Summary

The gateway appears to enter a restart loop in local macOS operation, but the restart is not caused by a process crash. The logs show repeated SIGTERM-driven shutdowns followed by clean restarts.

What I observed

Repeated pattern in live logs:

  • signal SIGTERM received
  • received SIGTERM; shutting down
  • shortly after: loading configuration…
  • then: ready (...)

This repeats while the process is otherwise healthy.

Important clarification

This does not look like a natural crash loop. It looks like an external reload / restart path is repeatedly terminating the gateway.

Why this matters

From the outside this feels like "gateway keeps dying", but the underlying cause is likely config/UI/reload churn rather than an internal fatal exception. That makes debugging much harder and can also break channel login flows while a user is trying to relink WhatsApp.

Related symptoms seen around the same time

  • repeated config reload lines
  • channel reconnect churn
  • Control UI / relink attempts during active troubleshooting

Related

  • refs #48994
  • refs #48658
  • refs #48703

Request

Please audit which paths are issuing SIGTERM / restart requests during normal operator use, especially around:

  • Control UI channel actions
  • config apply / config reload
  • channel health / relink actions
  • watchdog / doctor style flows

extent analysis

TL;DR

The gateway restart loop is likely caused by external SIGTERM signals triggered by config reloads or Control UI actions, and auditing these paths may help identify the root cause.

Guidance

  • Review the code paths related to Control UI channel actions, config apply/reload, and channel health/relink actions to identify potential sources of SIGTERM signals.
  • Investigate the watchdog/doctor style flows to determine if they are contributing to the restart loop.
  • Check the logs for patterns or correlations between the SIGTERM signals and specific user actions or system events.
  • Consider adding logging or debugging statements to track the origin of the SIGTERM signals and the restart requests.

Example

No code snippet is provided as the issue does not contain specific code references.

Notes

The issue appears to be related to external factors rather than an internal crash, making it harder to debug. The repeated config reloads and channel reconnect churn may be indicative of a larger issue with the system's configuration or communication flows.

Recommendation

Apply workaround: Audit and refine the config reload and Control UI action paths to prevent unnecessary SIGTERM signals and restarts, as the root cause is likely related to these areas.

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