При использовании OPenClaw коды ошибок могут вызывать головную боль. Независимо от того, произошёл ли сбой вызова API или тайм-аут соединения, быстрая диагностика проблемы позволяет восстановить рабочий процесс. В этой статье собраны наиболее частые ошибки OPenClaw и шаги по их ручному исправлению — чтобы вы не ходили по кругу.
Недействительный или просроченный ключ API
Код ошибки 401 обычно означает, что ключ неверен или истёк. Сначала войдите в панель управления OPenClaw и проверьте статус текущего ключа в разделе «API Keys». Если он отображается красным как «Expired», просто сгенерируйте новый ключ и замените им старый в коде. Обратите внимание: при копировании не должно быть лишних пробелов — многие новички спотыкаются именно об эту мелочь.
Если ключ действителен, но всё равно выдаётся ошибка 403, возможно, не выбраны нужные разрешения. Убедитесь, что ключу назначен доступ к необходимым моделям, например «claw-4» или «claw-vision». После сохранения подождите 1 минуту — синхронизация разрешений OPenClaw иногда запаздывает.
Лимит запросов (ошибка 429)
Слишком частые запросы вызывают Rate Limit — ошибку 429. Бесплатная версия OPenClaw допускает не более 30 запросов в минуту, платные — от 60 до 200 в зависимости от тарифа. Решение простое: добавьте задержку в код. Например, в Python используйте time.sleep(2), чтобы интервал между запросами составлял не менее 2 секунд. При пакетной обработке рекомендуется применять алгоритм экспоненциальной задержки.
Также проверьте, не запущено ли одновременно несколько скриптов. На панели Dashboard в разделе «Usage» можно в реальном времени увидеть частоту запросов — если она превышает красную линию, остановитесь и подождите несколько минут. После паузы запускайте снова, не стоит «пробивать» лимит в лоб.
