Сталкиваетесь с ошибками API или тайм-аутами в OPenClaw? В этой статье собраны типичные сценарии и практические решения, которые помогут быстро восстановить рабочий процесс и избавиться от раздражающих сообщений об ошибках.
Ошибка 401 Unauthorized: проверьте ключи и разрешения
Код 401 означает, что запросу не хватает действительных учётных данных. Сначала убедитесь, что ваш API-ключ правильно вставлен в переменные окружения или конфигурационный файл. Обратите внимание на лишние пробелы или переносы строк до и после ключа. Если вы скопировали ключ напрямую из консоли, попробуйте ввести его вручную — часто проблема в пропущенных символах при копировании. Кроме того, для некоторых моделей или Endpoint'ов требуются дополнительные права: зайдите в панель разработчика и проверьте, включён ли пункт «Разрешить доступ».
Ошибка 429: ограничение частоты запросов — настройте интервал и квоту
При отправке большого количества запросов за короткое время срабатывает лимит, возвращается код 429. Не пытайтесь сразу же повторять запросы — сначала сделайте паузу на 5–10 секунд, а затем используйте экспоненциальную задержку. Настройте очередь запросов или добавьте механизм sleep, чтобы не превышать лимит. Если ошибка возникает часто, проверьте, не на тестовом ли вы тарифе (у него обычно ниже квоты). Обновление плана или запрос на увеличение лимита решат проблему. Также убедитесь, что один и тот же API-ключ не используется одновременно другими приложениями — общий ключ быстро достигает порога.
Тайм-аут подключения или Socket Hang Up: проверьте сеть и прокси
«Connection Timeout» или «Socket Hang Up» обычно указывают на нестабильное сетевое соединение или неправильные настройки прокси. Сначала проверьте, можете ли вы напрямую подключиться к официальному серверу OPenClaw — используйте команды ping или curl для измерения задержки. Если вы используете прокси, убедитесь, что протокол и порт заданы верно, и что прокси не блокирует трафик. Некоторые корпоративные сети блокируют нестандартные порты — попробуйте переключиться на HTTPS-порт (443), это может помочь обойти ограничения. Кроме того, слишком короткий тайм-аут может вызывать ложные срабатывания: увеличьте параметр тайм-аута с 10 до 30 секунд.
Ошибка 500 Internal Server Error: сначала проверьте формат тела запроса
Если сервер возвращает 500, не спешите винить его — скорее всего, вы отправили неверно оформленный запрос. Проверьте, корректен ли JSON, не перепутаны ли имена полей (например, model вместо module). Особое внимание уделите булевым значениям и числам — не должны ли они быть в кавычках. Например, "temperature": true вызовет ошибку. Если тело запроса большое, попробуйте разбить его на части или проверьте, не содержит ли массив сообщений неподдерживаемые роли (например, вы случайно использовали роль function, которая недоступна для данной модели).
Ошибка 403 Forbidden: статус аккаунта и региональные ограничения
Код 403 может означать, что аккаунт заблокирован или запрос идёт из неподдерживаемого региона. Сначала войдите на сайт OPenClaw и проверьте статус аккаунта: нет ли задолженности или предупреждений о нарушении. Некоторые модели доступны только в определённых регионах — если ваш IP-адрес не входит в список разрешённых, попробуйте сменить узел или включить глобальный режим. У некоторых бесплатных тестовых аккаунтов доступ со временем снижается — продление подписки или переход на платный тариф обычно снимает ошибку 403.
