Пользователи OpenClaw при развертывании и запуске экземпляров нередко получают различные сообщения об ошибках, которые мешают эффективной работе. В этой статье мы разберем наиболее частые коды ошибок и предложим конкретные решения, чтобы вы могли быстро восстановить сервис и сократить время на диагностику.
Ошибка 401: сбой аутентификации
Ошибка 401 обычно указывает на истечение срока действия API-ключа или неверные настройки прав доступа. Сначала проверьте, не истек ли срок действия используемого ключа, и убедитесь, что роль, привязанная к ключу, имеет права на доступ к нужным ресурсам.
Если ключ еще действителен, попробуйте создать новый ключ в консоли OpenClaw и обновить его в файле конфигурации клиента. Не вставляйте ключ напрямую в код скрипта — используйте переменные окружения или менеджер секретов.
Ошибка 503: сервис временно недоступен
Ошибка 503 чаще всего возникает из-за нехватки ресурсов в регионе или планового обслуживания. Spot-инстансы OpenClaw особенно подвержены этой ошибке в часы пиковой нагрузки. Попробуйте переключиться на другой доступный регион для запуска экземпляра или подождите несколько минут и повторите попытку.
Если ошибка 503 возникает часто, рекомендуется включить автоматический механизм аварийного переключения и настроить несколько запасных регионов. Также проверьте, не превышен ли лимит ресурсов — в этом случае подайте запрос на увеличение квоты через консоль.
Ошибка 429: превышение лимита запросов
Слишком много API-вызовов за короткий промежуток времени приводит к ошибке 429 (лимит запросов). Для чувствительных операций (создание, удаление экземпляров) OpenClaw устанавливает ограничение на количество запросов в секунду. Решение — внедрить механизм экспоненциальной задержки при повторных попытках: после каждой неудачи увеличивайте время ожидания.
Если бизнесу действительно нужны частые вызовы, обратитесь в службу поддержки OpenClaw для повышения лимита запросов или используйте пакетные интерфейсы вместо одиночных операций, чтобы сократить общее число запросов.
Ошибка 400: неверный формат параметров
Ошибка 400 обычно связана с некорректными параметрами запроса: опечатка в имени типа инстанса, неверный формат ID образа и т.д. Сверьтесь с официальной документацией OpenClaw по API, особенно обращайте внимание на регистр символов и типы полей.
При использовании SDK или CLI OpenClaw старайтесь задействовать встроенную проверку параметров — это поможет выявить ошибки формата до отправки запроса. Кроме того, проверьте, нет ли в теле запроса лишних пробелов или спецсимволов, которые могут нарушить разбор данных.
Если вы столкнулись с другими кодами ошибок, не указанными здесь, в первую очередь обратитесь к таблице кодов ошибок в официальной документации OpenClaw. Либо отправьте логи через систему тикетов — техническая поддержка обычно предоставляет решение в течение часа. Также регулярно обновляйте клиент и SDK, чтобы избежать многих известных проблем.
