При работе с OPenClaw в AI-разработке вы рано или поздно столкнётесь с ошибками. Будь то сбой вызова API или проблемы с правами доступа — в этой статье мы разобрали несколько частых кодов ошибок и способы их решения. Надеемся, это поможет вам сэкономить время.
Ошибки аутентификации API: 401 и 403
Код 401 Unauthorized обычно означает, что ваш API-ключ недействителен или истёк. Проверьте, не потерялись ли символы при копировании, затем зайдите в раздел «API Keys» консоли OPenClaw и сгенерируйте новый ключ. Убедитесь, что копируете его без лишних пробелов в начале или конце. Ошибка 403 Forbidden чаще всего возникает, когда у ключа нет прав на доступ к определённому эндпоинту. Войдите в панель управления, проверьте настройки ролей и убедитесь, что вашему аккаунту назначены правильные Scope.
Тайм-ауты и сетевые проблемы: 408 и 429
408 Request Timeout — сервер слишком долго ждал ваш запрос. Обычно это связано с высокой задержкой сети или слишком большим телом запроса. Рекомендуем не превышать 2 МБ на один запрос и проверить стабильность вашего прокси-соединения. 429 Too Many Requests означает превышение лимита частоты запросов — у OPenClaw есть ограничение на количество запросов в минуту для каждого аккаунта. В этом случае подождите 60 секунд и повторите попытку, либо перейдите на более высокий тариф, чтобы увеличить квоту. Избегайте частых опросов.
Ошибки на стороне сервера: 500 и 502
500 Internal Server Error — временный сбой на сервере. Обычно команда OPenClaw исправляет его в течение нескольких минут. Зайдите на status.openclaw.com, чтобы проверить статус сервиса. Если всё в норме — повторите запрос. Если ошибка сохраняется, обратитесь в техподдержку, приложив полный лог запроса. 502 Bad Gateway чаще связан с проблемами на уровне шлюза — подождите 5 минут и повторите попытку. Не обновляйте страницу многократно.
Блокировка аккаунта и ограничения подписки
Если после входа вы видите Account Locked, скорее всего, вы несколько раз неверно ввели пароль или система обнаружила подозрительную активность. Сбросьте пароль через привязанную почту и проверьте последние попытки входа. Кроме того, некоторые продвинутые функции требуют определённого плана подписки. Если ошибка 400 Bad Request сопровождается сообщением «insufficient plan», значит ваш текущий тариф не поддерживает данную операцию — рекомендуем обновиться до версии Pro.
Полезные советы на каждый день
Приучите себя после каждого изменения кода или конфигурации запускать небольшой тест — это убережёт от множества ошибок. Также держите SDK OPenClaw в актуальной версии: старые версии могут выдавать странные ошибки из-за изменений в API. Если вы встретили непонятную ошибку, сразу открывайте страницу с описанием кодов ошибок в официальной документации — там вы найдёте наиболее точные пояснения.
