При вызове API OPenClaw нередко возникают ошибки 401 (Unauthorized), 500 (Internal Server Error) или тайм-аут соединения. Такие сбои не только прерывают рабочий процесс, но и могут приводить к потере данных. В этой статье мы разберём три наиболее частые ошибки, предложим анализ причин и пошаговые инструкции по исправлению — чтобы вы могли быстро восстановить работу.
401 Unauthorized: истёк ключ или недостаточно прав
Ошибка 401 обычно означает, что ваш API-ключ недействителен или у него нет доступа к указанному ресурсу. Первым делом проверьте, не истёк ли ключ или не был ли он случайно отозван — войдите в консоль OPenClaw и посмотрите статус ключа. Если ключ ещё действует, убедитесь, что у него есть необходимые разрешения (scope) для вызова текущей конечной точки.
Как исправить: создайте новый ключ и сразу замените им старый в коде. Если проблема остаётся, проверьте формат заголовка Authorization — он должен быть «Bearer ваш_ключ». Кроме того, некоторые продвинутые функции требуют обновления тарифа — уточните, покрывает ли ваш план нужный эндпоинт.
500 Internal Server Error: сбой на сервере и стратегия повторных запросов
Ошибка 500 означает внутренний сбой на стороне сервера OPenClaw, который не зависит от вашей конфигурации. Частые причины — временная перегрузка, ошибки базы данных или баги во время развёртывания обновлений. При такой ошибке не спешите менять код — сначала подождите 30 секунд и отправьте запрос снова.
