Перейти к основному содержанию

​
Pairing

«Сопряжение» — это явный шаг подтверждения владельцем в OpenClaw. Он используется в двух местах:
  1. Сопряжение личных сообщений (DM) (кто имеет право общаться с ботом)
  2. Сопряжение узлов (какие устройства/узлы могут подключаться к сети Gateway (шлюз))
Контекст безопасности: Security

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

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

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

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: краткоживущий токен сопряжения
Относитесь к коду настройки как к паролю, пока он действителен.

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

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 по‑прежнему требуют сопряжения устройств.

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