Causes
- Outdated firmware or app version — OpenClaw on the AI Hub requires firmware V3.1 or later and SwitchBot App V9.24.1 or above (iOS and Android). If your hub is still on an older firmware, the "Try OpenClaw" button and OpenClaw Setup page either don't appear or the one-click configuration fails partway through, because the OpenClaw container isn't present in the firmware image.
- No microSD card inserted — OpenClaw stores its models, logs, and configuration on the microSD card. If the included 16GB card was removed or was never formatted, the OpenClaw container has nowhere to write and the setup stalls or silently fails.
- The phone or computer isn't on the same local network as the hub — OpenClaw configuration requires the AI Hub and your phone/computer to be on the same Wi-Fi / local network. If the hub is on one SSID and your phone is on a guest network, a VPN, or mobile data, the setup page can't reach the hub and the configuration never completes.
- A slow or unstable internet connection during initial setup — the one-click setup downloads container images and dependencies, which normally takes 15–20 minutes. On public Wi-Fi, weak signals, or connections with packet loss, the download times out, the setup fails, or the container is left half-configured and crashes on launch.
- SwitchBot API rate limits or quota reached (the 401 error) — OpenClaw on the AI Hub calls SwitchBot's OpenAPI to control your devices. Each account is limited to 8,000 requests per month. Once the limit is reached, requests fail and OpenClaw returns a 401 error for the rest of the month. A 401 can also appear if the Home AI Agent trial has expired without an active subscription — OpenClaw is a subscription service after the one-month free trial.
- The OpenClaw Docker container crashed or corrupted — reviewers and early users report the bundled OpenClaw container is unstable and randomly reboots or crashes, especially after a firmware update or a failed setup. When the container is in this state, OpenClaw won't respond, the chat hangs, or the setup page shows an error on every attempt.
How to Fix
- Update the hub firmware and the app — in the SwitchBot app, go to the AI Hub's page → Settings → Firmware Update and install any available update (V3.1 or later is required for OpenClaw). Update the SwitchBot app itself to V9.24.1 or newer from the App Store / Google Play. Restart the hub after the update by unplugging the 12V adapter for 30 seconds.
- Verify the microSD card is inserted and formatted — confirm the included 16GB card (or a card up to 1TB) is fully seated in the slot on the right side of the device. If the hub prompts you to format the card after pairing, proceed with the formatting. Without a working card, OpenClaw setup cannot complete.
- Put your phone or computer on the same network as the hub — connect to the same Wi-Fi SSID as the AI Hub, and disable any VPN or private DNS on the device you're configuring from. Then open the setup page: SwitchBot app → AI Hub → Settings → OpenClaw Setup → tap Setup URL, or enter the URL in a browser on the same network.
- Re-run One-Click Setup on a stable connection — click One-Click Setup and let it run for the full 15–20 minutes without switching apps or letting the phone sleep. Avoid public Wi-Fi — use your home connection. If it fails mid-way, restart the setup rather than trying to use a half-configured instance.
- Resolve the 401 error — if you're past the one-month free trial, subscribe to the Home AI Agent service in the app ($4.99/month) — without an active subscription OpenClaw returns 401. If you have an active subscription, the 401 almost always means the 8,000 requests/month OpenAPI quota is exhausted; wait for the quota to reset next month, or reduce device-polling automations that burn requests. You can check remaining quota in the app's subscription/AI+ service page.
- Repair a crashed OpenClaw container — open the advanced/virtual terminal from the AI Hub's OpenClaw page and run
openclaw doctor --fix, which repairs common container issues. If the container won't recover, restart it from the OpenClaw setup page, and as a last resort restart the hub (unplug for 30 seconds). Users who hit repeated crashes report that a fresh one-click setup after a hub restart gives the most stable result. - Contact SwitchBot support if setup still fails — if you're on firmware V3.1+, the app is current, the card is in, the network is stable, and the container still won't set up or keeps returning 401 with an active subscription, contact SwitchBot via App → Profile → Support → Feedback. Include your firmware version and whether the 401 appears on setup or on device commands — this distinguishes a quota problem from a server-side account issue they can reset.