Ошибка 'gateway connect failed: pairing required' в OpenClaw: причина и решение

Как проявляется

При выполнении команд openclaw browser или openclaw gateway status появляется ошибка ‘gateway connect failed: pairing required’, хотя веб-консоль доступна.

Из-за чего возникает

OpenClaw требует одобрения нового устройства или браузера для CLI/WebSocket взаимодействия. CLI-устройство может иметь недостаточные права (только operator.read), что блокирует одобрение и вызывает ошибку.

Как исправить

1. На машине, где запущен шлюз, выполните команду для просмотра ожидающих запросов на сопряжение:

openclaw devices list

2. Одобрите нужный запрос, подставив из вывода предыдущей команды:

openclaw devices approve <requestId>

3. Если команда openclaw devices list также выдаёт ошибку, выполните ручное исправление:

• Отредактируйте файл ~/.openclaw/devices/paired.json, найдите устройство openclaw-probe и измените поля scopes и tokens.operator.scopes на:

["operator.read", "operator.admin", "operator.approvals", "operator.pairing"]

• Отредактируйте файл ~/.openclaw/identity/device-auth.json и аналогично измените tokens.operator.scopes.

4. Перезапустите шлюз:

openclaw gateway restart

5. Повторите попытку выполнения команд CLI, например:

openclaw browser --browser-profile openclaw start
openclaw gateway status

Если вы используете CLI с другой машины, повторите одобрение для каждого нового устройства/браузера.

Как не столкнуться снова

Одобряйте новые устройства и браузеры при первом подключении через CLI на хосте шлюза. Следите за правами scopes у CLI-устройств, чтобы избежать блокировок.

Источник

Разбор основан на обсуждении в репозитории проекта: issue #16305.

Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.