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

# Pairing

# Pairing

«Сопряжение» — это явный шаг **подтверждения владельцем** в OpenClaw.
Он используется в двух местах:

1. **Сопряжение личных сообщений (DM)** (кто имеет право общаться с ботом)
2. **Сопряжение узлов** (какие устройства/узлы могут подключаться к сети Gateway (шлюз))

Контекст безопасности: [Security](/gateway/security)

## 1. Сопряжение личных сообщений (входящий доступ к чату)

Когда для канала настроена политика личных сообщений `pairing`, неизвестные отправители получают короткий код, и их сообщение **не обрабатывается**, пока вы не одобрите доступ.

Политики личных сообщений по умолчанию описаны в разделе: [Security](/gateway/security)

Коды сопряжения:

* 8 символов, верхний регистр, без неоднозначных символов (`0O1I`).
* **Истекают через 1 час**. Бот отправляет сообщение с кодом сопряжения только при создании нового запроса (примерно раз в час на отправителя).
* Ожидающие запросы на сопряжение личных сообщений по умолчанию ограничены **3 на канал**; дополнительные запросы игнорируются, пока один из существующих не истечёт или не будет одобрен.

### Одобрить отправителя

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw pairing list telegram
openclaw pairing approve telegram <CODE>
```

Поддерживаемые каналы: `telegram`, `whatsapp`, `signal`, `imessage`, `discord`, `slack`.

### Где хранится состояние

Хранится в `~/.openclaw/credentials/`:

* Ожидающие запросы: `<channel>-pairing.json`
* Список разрешённых (allowlist) одобренных отправителей: `<channel>-allowFrom.json`

Считайте эти данные чувствительными (они контролируют доступ к вашему ассистенту).

## 2. Сопряжение устройств-узлов (iOS/Android/macOS/headless узлы)

Узлы подключаются к Gateway (шлюз) как **устройства** с `role: node`. Gateway (шлюз)
создаёт запрос на сопряжение устройства, который необходимо одобрить.

### Сопряжение через Telegram (рекомендуется для iOS)

Если вы используете плагин `device-pair`, вы можете выполнить первичное сопряжение устройства полностью из Telegram:

1. В Telegram отправьте вашему боту сообщение: `/pair`
2. Бот отвечает двумя сообщениями: инструкцией и отдельным сообщением с **кодом настройки** (удобно копировать/вставлять в Telegram).
3. На телефоне откройте приложение OpenClaw для iOS → Settings → Gateway.
4. Вставьте код настройки и подключитесь.
5. Вернувшись в Telegram: `/pair approve`

Код настройки — это JSON‑пакет, закодированный в base64, который содержит:

* `url`: URL WebSocket шлюза (`ws://...` или `wss://...`)
* `token`: краткоживущий токен сопряжения

Относитесь к коду настройки как к паролю, пока он действителен.

### Одобрить устройство-узел

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw devices list
openclaw devices approve <requestId>
openclaw devices reject <requestId>
```

### Хранение состояния сопряжения узлов

Хранится в `~/.openclaw/devices/`:

* `pending.json` (краткоживущее; ожидающие запросы истекают)
* `paired.json` (сопряжённые устройства + токены)

### Примечания

* Устаревший API `node.pair.*` (CLI: `openclaw nodes pending/approve`) — это
  отдельное хранилище сопряжения, управляемое Gateway (шлюз). Узлы WS по‑прежнему требуют сопряжения устройств.

## Связанная документация

* Модель безопасности + prompt injection: [Security](/gateway/security)
* Безопасное обновление (запуск doctor): [Updating](/install/updating)
* Конфигурации каналов:
  * Telegram: [Telegram](/channels/telegram)
  * WhatsApp: [WhatsApp](/channels/whatsapp)
  * Signal: [Signal](/channels/signal)
  * BlueBubbles (iMessage): [BlueBubbles](/channels/bluebubbles)
  * iMessage (legacy): [iMessage](/channels/imessage)
  * Discord: [Discord](/channels/discord)
  * Slack: [Slack](/channels/slack)