Что делать с ошибкой «pairing required» в OpenClaw

Ошибка pairing required возникает, когда OpenClaw Gateway не связан с конкретным агентом или каналом, через который вы пытаетесь общаться. Pairing — это процесс связывания: Gateway должен «знать», какой агент отвечает на сообщения из какого мессенджера и от какого пользователя. Без выполненного pairing Gateway возвращает ошибку и отказывается обрабатывать сообщения.

Когда чаще всего возникает. Сразу после первой установки, если вы пропустили шаг openclaw onboard. Также — после ручной правки конфига, когда вы добавили нового агента или канал, но не перезапустили Gateway и не выполнили подтверждение. И ещё — при попытке использовать одного и того же бота с двух установок OpenClaw одновременно: pairing «привязывается» к одной инсталляции.

Как решить — самый простой путь. Запустите openclaw onboard заново. Мастер сам определит, какие агенты не связаны, и проведёт через подтверждение. Для Telegram это обычно: бот пишет в чат «Подтверди связывание» с уникальным кодом, вы подтверждаете в терминале, Gateway фиксирует pair. Время — 1–2 минуты.

Если onboard не помогает. Проверьте, что Gateway действительно запущен и слушает порт. Команда openclaw status покажет статус всех агентов и каналов. Если канал в статусе error или unauthorized — его нужно отвязать (openclaw pair revoke) и привязать заново.

Конфликт с другой инсталляцией. Если вы недавно пробовали OpenClaw на другой машине и не отвязали бота, текущая установка может получать pairing required, потому что Telegram считает «активной» предыдущую сессию. Решение — на старой машине выполните openclaw pair revoke (или удалите OpenClaw), на новой — повторно openclaw onboard.

Профилактика. После любой существенной правки openclaw.json (добавили агента, поменяли модель главного агента, изменили список каналов) — перезапускайте Gateway: openclaw gateway restart. Это безопасная операция, она не теряет данные памяти и подписок.

# Самый быстрый способ — повторить onboarding
openclaw onboard

# Проверить статус всех агентов и каналов
openclaw status
openclaw pair list

# Отвязать сломанный pair и привязать заново
openclaw pair revoke <agent-id>
openclaw onboard