#error

1 messages · Page 1 of 1 (latest)

keen furnace
#

⚠️ Agent failed before reply: Gateway is draining for restart; new tasks are not accepted.
Logs: openclaw logs --follow

what does it mean?!

frozen pawnBOT
solar driftBOT
#

To help others find answers, you can mark your question as solved via Right click solution message -> Apps -> âś… Mark Solution

frozen pawnBOT
tough tartanBOT
#

It means the Gateway was already restarting/shutting down when that message hit, so it refused to start a new agent task.

In plain English: OpenClaw wasn’t broken by your prompt, it was in a restart window.

Usually that happens because of one of these:

  • someone ran openclaw gateway restart
  • a config change triggered a restart
  • an update/reload happened
  • the gateway crashed and is coming back up

I’d check these first:

openclaw --version
openclaw gateway status
openclaw logs --follow
#

What to expect:

  • if gateway status says running, retry the message
  • if it keeps happening, the gateway is probably stuck in a restart loop or crashing on startup, and the logs will show why

Troubleshooting doc: https://docs.openclaw.ai/gateway/troubleshooting

If you paste the output of openclaw --version and openclaw gateway status, I can help read it.

keen furnace
#

everytime there is a new update, it breaks?!?! why?!?!

tough tartanBOT
#

Yeah, that’s frustrating.

This specific error usually does not mean the update permanently broke OpenClaw. It means the update triggered a gateway restart, and your message landed during the brief drain window.

That part is actually by design. The update docs say openclaw update runs doctor and restarts the gateway:
https://docs.openclaw.ai/install/updating

So:

  • One failed message right during/after update = expected-ish
  • Gateway stays broken / keeps doing this for minutes = not expected, probably a crash loop or bad startup after update

Can you paste these?

openclaw --version
#
openclaw gateway status
openclaw logs --follow

If it’s just the restart window, retrying the message after the gateway is back should work.
If it keeps failing, we’ll need the logs to see what the update is tripping over.

Troubleshooting doc: https://docs.openclaw.ai/gateway/troubleshooting

keen furnace
#

not true, its been an hour, still same message, so it wont restart gateway........

tough tartanBOT
#

Yeah, you’re right, after an hour this is not the normal restart window. It’s stuck.

At this point I’d assume one of these:

  • the gateway got wedged in a draining state
  • startup is failing after the update
  • there’s a duplicate/stale service confusing the restart

Please run these and paste the output:

openclaw --version
openclaw gateway status --deep
openclaw doctor
openclaw logs --follow

If gateway status says running but new tasks still fail, try a manual bounce:

#
openclaw gateway restart

If that still doesn’t clear it, the logs are the key, especially lines like:

  • gateway startup failed
  • EADDRINUSE
  • invalid config
  • Other gateway-like services detected

Docs: https://docs.openclaw.ai/gateway/troubleshooting

So, short version: you’re not seeing a normal update delay anymore, you’re seeing a stuck/bad restart. Paste version + status and I’ll help narrow it down.

keen furnace
#

how do i update to latest without breaking anything in the most safe way?! i use windows

tough tartanBOT
#

Safest on Windows:

  1. Use WSL2 if you can. The docs still call WSL2 the more stable/recommended Windows path.
  2. Stay on stable, not beta/dev.
  3. Update manually, not with surprise auto-updates.
  4. Use openclaw update, not raw npm/pnpm, because it detects your install type, runs doctor, and restarts the gateway cleanly.

Recommended flow:

openclaw --version
openclaw update --dry-run
openclaw update
openclaw gateway status
openclaw health
#

My honest recommendation:

  • If you’re already on WSL2, this is the safest path.
  • If you’re on native Windows and stability is your top priority, I’d seriously consider moving to WSL2 before the next update.

Docs:

If you want, paste the output of:

openclaw --version

and tell me whether you’re on native Windows or WSL2, and I’ll give you the safest exact update steps for your setup.