Skip to main content
For each device you can:
  • 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=...)
Pairing request disappeared before I could approve it?
  • Requests expire if the device disconnects before approval
  • Have the device open the access link again to re-send the request
Device shows as Paired but won’t connect?
  • 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

  1. Access link — your bot has a unique private URL containing a secret token: https://{slug}.myclaw.cc?token=...
  2. Pairing request — when a device opens this link, the bot receives an automatic pairing request
  3. Your approval — you approve the request in the dashboard under Device Pairings
  4. Paired — the device is now authorized to send messages to your bot
Keep your access link private. Anyone who has it can submit a pairing request to your bot. They still need your approval before they can connect.

Step-by-step

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
The link format is: https://{slug}.myclaw.cc?token={secret-token} 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
Opening the link triggers an automatic pairing request to your bot.

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
Click Approve to pair the device. Click Reject to deny it.
Once approved, the device shows as Paired and can start chatting with your bot.

Managing paired devices

The Device Pairings table shows all currently pair