- Revoke — remove the device’s authorization. The device will need to re-pair to reconnect.
Revoking a device does not delete the device’s chat history stored on the device itself.
Troubleshooting
No pending request after opening the link?- Make sure your bot status is running — pairing requires the bot to be online
- Try clicking Refresh in the Device Pairings section
- Check that you opened the correct access link (with
?token=...)
- Requests expire if the device disconnects before approval
- Have the device open the access link again to re-send the request
- Try revoking and re-pairing
- Make sure the bot is in running state--- title: Connect a Device description: Pair your browser, CLI, or mobile app to your running bot
Your bot communicates with devices through a pairing system. Any device — browser, CLI, or mobile app — must be approved before it can chat with your bot.
How pairing works
- Access link — your bot has a unique private URL containing a secret token:
https://{slug}.myclaw.cc?token=... - Pairing request — when a device opens this link, the bot receives an automatic pairing request
- Your approval — you approve the request in the dashboard under Device Pairings
- Paired — the device is now authorized to send messages to your bot
Step-by-step
1. Copy your access link
Open the bot detail page and find the Access link section.- Click Reveal to show the full URL (with token)
- Click Copy to copy it to clipboard
- Click Open to open it immediately in your current browser
https://{slug}.myclaw.cc?token={secret-token}
2. Open the link on your device
Open the access link on the device you want to pair:- Browser: paste the URL into the address bar
- OpenClaw CLI: run
openclaw connect "https://{slug}.myclaw.cc?token=..." - Mobile app: open the URL in the app’s connect screen
3. Approve the pairing
In the dashboard on the bot detail page, scroll to Device Pairings and click Refresh. You’ll see the pending request with:- Device ID: a unique identifier (hash) for the device
- Platform: the OS or client type (e.g. Win32, linux, iOS)
- Time: when the request was made
Once approved, the device shows as Paired and can start chatting with your bot.