Как проявляется
Все CLI-команды и межагентские сессии завершаются ошибкой ‘gateway closed (1008): pairing required’, несмотря на запущенный процесс шлюза.
Из-за чего возникает
В версии 2026.2.19-2 введена новая жёсткая проверка WebSocket handshake, из-за чего существующие пары клиентов не распознаются, и требуется повторное сопряжение.
Как исправить
- Остановите шлюз:
openclaw gateway stop- Сделайте резервную копию и удалите файлы сопряжения:
mkdir -p "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices"
[ -f "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/paired.json" ] && mv "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/paired.json" "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/paired.json.bak"
[ -f "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/pending.json" ] && mv "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/pending.json" "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}/devices/pending.json.bak"(Для старых установок замените ~/.openclaw на ~/.clawdbot)
- Запустите шлюз заново:
openclaw gateway start- Проверьте состояние:
openclaw health-
Для окончательного решения обновитесь до версии с исправлением из PR #21447, после чего перезапустите шлюз и проверьте здоровье.
-
При необходимости выполните повторное сопряжение устройств.
Как не столкнуться снова
Следите за обновлениями OpenClaw и своевременно обновляйтесь до версий с исправлениями, чтобы избежать проблем с сопряжением.
Источник
Разбор основан на обсуждении в репозитории проекта: issue #21236.
Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.