Gateway wont start | Friends of the Crustacean 🦞🤝 | Page 1

sly karma Apr 16, 2026, 3:47 PM

#

Gateway start blocked: existing config │
│ is missing gateway.mode. Treat this as suspicious or clobbered config. Re-run openclaw │ │ onboard --mode local or openclaw setup, set gateway.mode=local manually, or pass │
│ --allow-unconfigured.

But I ran openclaw setup and got the error stayed

cosmic dewBOT Apr 16, 2026, 3:47 PM

#

manic isleBOT Apr 16, 2026, 3:49 PM

#

openclaw setup is supposed to write gateway.mode=local, so if the error stayed, my guess is one of two things:

gateway is reading a different config file than setup wrote, or
you're on an older version with a config-write bug.

Can you paste the output of these 3 commands first?

openclaw --version
openclaw config file
openclaw config get gateway.mode

If gateway.mode comes back empty/unset, force it manually:

#

openclaw config set gateway.mode local
openclaw config get gateway.mode
openclaw gateway start

If that still fails, paste the exact output from those commands and I’ll narrow it down.

Relevant docs:

Small note, --allow-unconfigured is only a temporary bypass, it does not repair the config.

sly karma Apr 16, 2026, 3:50 PM

#

openclaw --version
openclaw config file
openclaw config get gateway.mode
OpenClaw 2026.4.14 (323493f)

🦞 OpenClaw 2026.4.14 (323493f) — iMessage green bubble energy, but for everyone.

~/.openclaw/openclaw.json

🦞 OpenClaw 2026.4.14 (323493f) — Your second brain, except this one actually remembers where you left things.

local

manic isleBOT Apr 16, 2026, 3:52 PM

#

Nice, that helps a lot.

Since openclaw config get gateway.mode already says local, the problem is probably not the current CLI config. The next likely culprit is service/profile drift, meaning the background Gateway is reading a stale config or different state dir.

Can you run these and paste the output?

openclaw gateway status --deep
openclaw config validate

Also, which exact command is failing?

openclaw gateway
# or

#

openclaw gateway run
# or
openclaw gateway start

That distinction matters:

If openclaw gateway works, but openclaw gateway start fails, it is almost certainly the managed service metadata.
If both fail, I want to see what status --deep says about the config path/service path.

If status --deep shows the CLI config and service config disagree, the docs-recommended repair is:

openclaw gateway install --force
openclaw gateway restart

#Gateway wont start