OPenClaw — это шлюз с открытым исходным кодом для AI, и при его использовании новички часто сталкиваются с HTTP-ошибками. В этой статье мы сосредоточимся на двух самых частых кодах — 403 и 429, чтобы помочь вам быстро локализовать проблему и возобновить вызовы.
403 Доступ запрещён: права на ключ и ограничения по IP
При получении ошибки 403 в первую очередь проверьте, не истёк ли API-ключ или не был ли он деактивирован. В консоли OPenClaw можно сгенерировать новый ключ — не забудьте скопировать его и сразу обновить в файле конфигурации. Кроме того, некоторые поставщики моделей устанавливают белый список для исходных IP-адресов: если ваш VPS или прокси-IP не входит в разрешённый диапазон, вы также получите 403. Зайдите в панель управления, найдите раздел «Разрешённые IP», добавьте свой текущий исходящий IP — и блокировка будет снята. Ещё один вариант: после исчерпания бесплатного лимита вы продолжаете отправлять запросы — в этом случае аккаунт временно ограничивается. Нужно пополнить баланс или переключиться на платный тариф.
429 Слишком много запросов: лимиты скорости и стратегия повторных попыток
Код 429 означает, что вы отправили слишком много запросов за короткое время и превысили порог скорости, установленный OPenClaw. Решение простое: приостановите отправку, подождите несколько десятков секунд и повторите. Более надёжный подход — внедрить в код логику экспоненциальной задержки: например, после каждой неудачи ждать 2, 4, 8 секунд (постепенно увеличивая интервал). Также проверьте свой тарифный план: разные пакеты OPenClaw имеют разные лимиты на количество запросов в минуту (RPM). Переход на более высокий тариф даст более высокую квоту. Если вы используете общий ключ, старайтесь не запускать массовые запросы одновременно с другими — лучше оформить отдельный API-ключ.
Другие частые ошибки: 500 и 502
Иногда встречаются ошибки 500 Internal Server Error или 502 Gateway Timeout. Обычно это проблемы на стороне бэкенда OPenClaw или вышестоящего провайдера. Попробуйте подождать 5 минут и повторить запрос. Если ошибка сохраняется, сообщите о ней в официальный GitHub Issues или в Discord-чат. Следите за страницей статуса (status.openclaw.com) — там публикуются уведомления о сбоях. При локальной отладке советуем включить подробные логи — это поможет быстрее понять, проблема в конфигурации или на стороне сервера. Также регулярно обновляйте образ OPenClaw: в старых версиях могут быть известные баги, которые вызывают подобные ошибки.
