Ошибка 'pairing required' в OpenClaw 2026.2.19-2: причина и решение

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

Все CLI-команды и межагентские сессии завершаются ошибкой ‘gateway closed (1008): pairing required’, несмотря на запущенный процесс шлюза.

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

В версии 2026.2.19-2 введена новая жёсткая проверка WebSocket handshake, из-за чего существующие пары клиентов не распознаются, и требуется повторное сопряжение.

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

1. Остановите шлюз:

openclaw gateway stop

2. Сделайте резервную копию и удалите файлы сопряжения:

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)

3. Запустите шлюз заново:

openclaw gateway start

4. Проверьте состояние:

openclaw health

5. Для окончательного решения обновитесь до версии с исправлением из PR #21447, после чего перезапустите шлюз и проверьте здоровье.

6. При необходимости выполните повторное сопряжение устройств.

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

Следите за обновлениями OpenClaw и своевременно обновляйтесь до версий с исправлениями, чтобы избежать проблем с сопряжением.

Источник

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

Похожие сбои и их причины собраны в разборе частых ошибок OpenClaw.

Другие ошибки шлюза и соединения: disconnected (1008) и gateway closed (1006).