При использовании OPenClaw неизбежно возникают различные сообщения об ошибках. В этой статье мы систематизировали самые распространённые коды ошибок, с которыми сталкиваются пользователи, включая сценарии входа, проверки подлинности, сетевого подключения и вызовов API. Вы получите готовые к применению решения, которые помогут быстро вернуться к нормальной работе.
Ошибки входа и авторизации: 401 и 403
Сообщение 401 Unauthorized обычно означает, что API-ключ недействителен или истёк. Перейдите в консоль OPenClaw, сгенерируйте новый ключ и убедитесь, что строка ключа указана в коде правильно. Обратите внимание: ключ чувствителен к регистру, и при копировании не должно быть лишних пробелов.
403 Forbidden говорит о том, что у вашей учётной записи недостаточно прав для выполнения данного действия. Чаще всего это происходит, когда пользователь бесплатного тарифа пытается получить доступ к платным функциям. Рекомендуем проверить статус подписки; если требуется обновление, переключите тариф в настройках аккаунта. Если подписка активна, а ошибка всё равно появляется, обратитесь в поддержку для обновления прав доступа.
Сетевые ошибки и ошибки соединения: Timeout и Connection Reset
Тайм-аут (Timeout) чаще всего вызван нестабильным интернет-соединением или временной перегрузкой серверов OPenClaw. Сначала попробуйте сменить сеть — например, переключиться с Wi‑Fi на мобильные данные. Если проблема сохраняется, увеличьте время ожидания запроса, например, с 30 секунд по умолчанию до 60 секунд.
Connection Reset означает, что соединение было прервано. Обычно это связано с блокировкой IP-диапазонов OPenClaw файрволом или прокси. Добавьте официальные домены OPenClaw в белый список, отключите VPN или настройте правила прокси. Корпоративным пользователям также стоит проверить исходящие политики безопасности, которые могут ограничивать внешние API-запросы.
Ошибки вызовов API: 429 и 500
429 Too Many Requests — самая распространённая ошибка, связанная с лимитами. OPenClaw ограничивает частоту вызовов: бесплатный тариф — до 20 запросов в минуту, платные тарифы предоставляют более высокие квоты. Решение — снизить частоту запросов или внедрить механизм повторных попыток с экспоненциальной задержкой. Если ваш бизнес требует высокой нагрузки, рассмотрите возможность перехода на более дорогой тариф для увеличения квоты.
500 Internal Server Error указывает на временный сбой на стороне сервера OPenClaw. Сначала проверьте официальную страницу статуса OPenClaw — возможно, идёт техническое обслуживание. Если это кратковременная проблема, подождите 3–5 минут и повторите попытку. При повторяющихся ошибках отправьте запрос в поддержку, приложив полные логи запроса — это поможет техническим специалистам локализовать проблему. Старайтесь не отправлять один и тот же запрос слишком часто, чтобы не попасть под лимит.
Блокировка учётной записи или подозрительный вход
Несколько неудачных попыток ввода пароля или вход из необычного региона могут активировать механизм защиты OPenClaw, что приведёт к временной блокировке учётной записи. В таком случае используйте ссылку для разблокировки, отправленную на зарегистрированную почту, или сбросьте пароль через SMS-код. Если код не приходит, проверьте папку «Спам» в почте и убедитесь, что номер телефона привязан и не заблокирован оператором. Для учётных записей с высоким риском, которые долго не используются, рекомендуется включить двухфакторную аутентификацию (2FA) — это снизит вероятность ложной блокировки.
