Как проявляется
При попытке подключения появляется сообщение disconnected (1008): pairing required, и устройство не подключается.
Из-за чего возникает
В новой версии OpenClaw требуется подтверждение (pairing) устройств. Ошибка возникает, если есть неподтверждённые запросы на сопряжение.
Как исправить
- Проверьте список ожидающих подтверждения устройств через CLI:
openclaw devices list
- Одобрите все ожидающие запросы, указав их ID:
openclaw devices approve <request id>
- Если вы используете Docker и не можете работать с CLI, внесите в конфигурационный файл
~/.openclaw/openclaw.jsonследующие изменения, чтобы разрешить небезопасную авторизацию:
{
"gateway": {
"mode": "local",
"bind": "lan",
"port": 18789,
"controlUi": {
"enabled": true,
"allowInsecureAuth": true
},
"auth": {
"mode": "token",
"token": "your-token-here"
}
},
"agents": {
"defaults": {
"workspace": "/root/clawd"
}
}
}
- Для Docker также рекомендуют:
- Исправить сетевые настройки в
docker-compose.ymlдляopenclaw-cli, чтобы CLI мог обращаться к шлюзу по имени контейнера. - Убедиться, что токен в
openclaw.jsonсовпадает с переменной окруженияOPENCLAW_GATEWAY_TOKEN. - Одобрять устройства из контейнера шлюза, если CLI не работает:
docker compose exec openclaw-gateway node dist/index.js devices
- Если проблема с веб-интерфейсом на другом компьютере в LAN, настройте
bindв конфиге наlan.
Дополнительно: следите за обновлениями, возможно, появится GUI для управления устройствами без CLI.
Как не столкнуться снова
Всегда проверяйте и одобряйте запросы на сопряжение устройств после обновления OpenClaw. Настраивайте конфигурацию для корректной работы в вашей среде (LAN, Docker).
Источник
Разбор основан на обсуждении в репозитории проекта: issue #4531.
Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.