Keeping your ClawBox current gets you the newest features and fixes. Updates never touch your data — settings, AI keys, chats, and channel tokens live outside the app code and are preserved.
1

Open System Update

Browse to http://YOUR_BOX_IP, log in, and open the System Update app (also reachable from Settings).
2

Start the update

If a new version is available, click Update. The app shows live progress through every step.
3

Let it reboot

The final step reboots the box — it’s offline for a minute or two. That’s normal, not a hang. When it’s back, the update is done.
Optional, for extra peace of mind before any update — make a dated backup of your settings (over SSH or the Terminal app):
cp -r ~/.openclaw ~/.openclaw.backup-$(date +%F)

​
Update over SSH (headless alternative)

Same update, no browser needed: 
ssh clawbox@YOUR_BOX_IP        # your system password from setup
sudo clawbox update
The password prompt won’t show characters as you type — that’s normal. Let the installer finish completely (it prints numbered steps), then the box reboots.

​
An update got stuck, or the box misbehaves afterward

On older versions the in-app update could stall midway (usually when the device had local code changes). The fix is the recovery updater — a standalone one-liner that hard-syncs the box to the latest release and rebuilds everything, keeping your data:
1

Connect over SSH

ssh clawbox@YOUR_BOX_IP
Use the device’s IP address rather than clawbox.local — the name relies on mDNS, which many Windows machines and routers handle unreliably (find the IP in your router’s connected-devices list).
2

Run the recovery updater

bash <(curl -fsSL https://raw.githubusercontent.com/ID-Robots/clawbox/main/scripts/force-update.sh)
Takes 10–15 minutes — let it finish completely.
3

Confirm it's back

systemctl is-active clawbox-setup clawbox-gateway
Both should print active. Then reload http://YOUR_BOX_IP and send your assistant a message — a reply confirms everything is running.
More recovery options (password reset, safe reinstall, factory reset) are on the Recovery page; deeper diagnosis lives in Troubleshooting. For how updates work under the hood (release channels, what survives, version pinning), see the Update System reference.
If any step returns an error, stop there rather than forcing it — reach out and we’ll finish it together: email [email protected] or join our Discord community.