Everything you need to go from unboxing to dashboard in about 30 minutes.
Go to chatgpt.com → Settings → Security → toggle ON “Device code authorization for Codex”.
You must do this before starting the wizard or the OpenAI sign-in step will fail with a “not enabled” error.
Don't configure Wi-Fi, SSH, or hostname in Imager — ClawRig handles all of this automatically during its setup wizard.
If the portal doesn't appear, go back out of the Wi-Fi connection screen, then tap the ClawRig network again. It may take a moment to load.
Using Ethernet instead? Tap “Skip Wi-Fi setup” on the portal page. The Pi is already online through the Ethernet cable and will show you the IP address to use on your computer.
On your computer, open a browser and go to http://<IP> (the address shown at the end of step 4). The wizard walks you through three steps, then shows your dashboard address and asks you to save it before finishing:
Automatic — the wizard verifies the Pi is online.
A code appears on screen. Open the link on your phone and enter the code when prompted.
Create a bot via @BotFather on Telegram and paste the token. You can skip this and set it up later from the dashboard.
At the end of the wizard, your Pi's IP address is shown on screen. Bookmark it or write it down — you'll confirm you've saved it before the wizard finishes. ClawRig then redirects to your dashboard, where you can manage Wi-Fi, accounts, system settings, and check on your OpenClaw agent.
Your IP is also visible on the dashboard's System tab if you need it later. If you ever lose the address, use the tool below.
Lost the link to your ClawRig? Use one of these methods to get back to your dashboard.
Your device's address is http://clawrig-XXXX.local (where XXXX is your device's unique code). Works in Safari and Firefox — Chrome typically does not support .local addresses.
If the .local address didn't work, enter your Pi's IP address below.
Check the setup wizard — your Pi's IP address is shown at the end of the wizard. You'll be asked to save it before finishing.
Check your router's admin page — usually at 192.168.1.1 or 192.168.0.1. Look for a device named “clawrig-XXXX” in the connected devices list.
Use a network scanner app — download a free scanner on your phone: Net Analyzer (iOS & Android, free) or Fing (iOS & Android, 3 free scans/day). Open the app while connected to the same Wi-Fi and look for a device named “clawrig-XXXX”.
Make sure your phone is connected to the ClawRig-XXXX-Setup Wi-Fi network. If the portal doesn't appear, go back out of the Wi-Fi settings, then tap the ClawRig network again and wait a moment. Sometimes it takes a second try.
If the network doesn't show up at all, wait 60 seconds after powering on the Pi — the hotspot takes a moment to start.
Your device's address is http://clawrig-XXXX.local (where XXXX is your device's unique code). This works in Safari and Firefox but typically does not work in Chrome. Try using the IP address instead — see Find Your Dashboard above.
On Windows, .local addresses require Bonjour Print Services to be installed. On Mac and Linux it should work out of the box.
You need to enable device code authorization first. Go to chatgpt.com → Settings → Security → toggle ON “Device code authorization for Codex”.
After enabling it, go back to the wizard and try the sign-in step again.
This is normal — the Pi's hotspot shuts down while connecting to your home Wi-Fi. Once connected, the Pi joins your home network with a new IP address.
Go to your computer and use the IP address that was shown on the connecting page. If you didn't catch the IP, see Find Your Dashboard above.
Your Pi's IP address is shown at the end of the setup wizard — you'll be asked to save it before finishing. You can also find it on the dashboard's System tab.
If you've lost it, check your router's admin page (usually 192.168.1.1 or 192.168.0.1) and look for a device named “clawrig-XXXX”. Or use a free network scanner app like Net Analyzer or Fing on your phone.
Each ClawRig gets a unique identifier (e.g., clawrig-a3f7, clawrig-d2c1), so their hotspot names and .local addresses won't collide. You can reach each one by its own http://clawrig-XXXX.local address or IP.
Check your router's admin page to see all connected devices and their IP addresses.