> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myclaw.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Device

> Connect device to gateway from the dashboard

For each device you can:

* **Revoke** — remove the device's authorization. The device will need to re-pair to reconnect.

<Info>Revoking a device does not delete the device's chat history stored on the device itself.</Info>

## 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

<Warning>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.</Warning>

## 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

The link format is: `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

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.

<Check>Once approved, the device shows as **Paired** and can start chatting with your bot.</Check>

## Managing paired devices

The **Device Pairings** table shows all currently pair