Сопряжение¶
«Сопряжение» — это явный шаг подтверждения владельцем в OpenClaw. Он используется в двух местах:
- Сопряжение личных сообщений (DM) (кто имеет право общаться с ботом)
- Сопряжение узлов (какие устройства/узлы могут подключаться к сети 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:
- В Telegram отправьте вашему боту сообщение:
/pair - Бот отвечает двумя сообщениями: инструкцией и отдельным сообщением с кодом настройки (удобно копировать/вставлять в Telegram).
- На телефоне откройте приложение OpenClaw для iOS → Settings → Gateway.
- Вставьте код настройки и подключитесь.
- Вернувшись в 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 по‑прежнему требуют сопряжения устройств.