Errors / Device Token Mismatch
Fix: Device Token Mismatch
Error: "device token mismatch" or "device identity has changed"
What It Means
Your device's identity has changed. OpenClaw recognizes devices by a unique ID stored in your config. When that ID changes (new install, moved config, restored backup), it sees it as a different device and blocks access for security.
Common Causes
- •Fresh OpenClaw installation
- •Moved or deleted your ~/.openclaw directory
- •Restored from a backup
- •Changed device or hostname
Ask Your Agent to Fix This
Copy this prompt and send it to your OpenClaw agent:
I'm getting a "device token mismatch" error. Delete the devices
folder in my ~/.openclaw directory, restart the gateway, and
re-list my available devices so I can pair again.
How to Fix It
Quick Fix
- Delete the devices folder:
- Restart the gateway:
- Re-pair your devices through the dashboard or CLI
rm -rf ~/.openclaw/devices
openclaw gateway restart
Verify the Fix
openclaw devices list
How to Prevent This
- ✓Don't delete or move your ~/.openclaw directory
- ✓Back up the entire ~/.openclaw folder, not just config
- ✓If moving to a new machine, copy the whole ~/.openclaw directory
Related Errors
Related Guides
Still having trouble?
Ask on Discord