From 4aa8b206b0c6ff603c5085522866e8d6b6c588fa Mon Sep 17 00:00:00 2001 From: adadrag Date: Thu, 12 Mar 2026 17:55:27 +0000 Subject: [PATCH] Add onboarding wizard notes to README Explains the two expected warnings (gateway service install failed, ws:// security warning) so users don't worry about them. Co-Authored-By: Claude Opus 4.6 --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 84b4ee9..7fcde0c 100644 --- a/README.md +++ b/README.md @@ -102,6 +102,16 @@ pct start # Start the container pct status # Check container status ``` +## Notes on the onboarding wizard + +When you run the **OpenClaw Setup Wizard** from the desktop shortcut, you may see two messages that look like errors but are perfectly normal: + +**"Gateway service install failed"** — The wizard tries to create its own systemd service for the gateway, but our script already set up `openclaw-gateway.service` and it's already running. This is safe to ignore. + +**"SECURITY ERROR: ws:// to a non-loopback address"** — This is a warning that the gateway uses unencrypted WebSocket over LAN. This is expected for a local setup. If you're on a trusted home or office network, it's completely fine. + +As long as you see your **channels connected**, a **Control UI URL**, and an **agent workspace** listed at the end of the wizard, everything worked. + ## Troubleshooting **Service not starting?**