При использовании AI-агента OpenClaw часто возникают ошибки или проблемы с подключением аккаунта. В этой статье для пользователей OpenClaw собраны шаги по диагностике и решения типичных ошибок: сбой входа, исключения API, разрыв прокси-соединения и другие. Материал поможет быстро восстановить正常工作 инструмента.
Ошибки входа и привязки аккаунта
Если при входе появляется сообщение «неверный логин или пароль», проверьте, не включён ли Caps Lock, или попробуйте сбросить пароль через email. При получении уведомления «аккаунт заблокирован» — это обычно результат многократного ввода неверного пароля. Подождите 15 минут и повторите попытку. Если при привязке email отображается «ошибка отправки кода подтверждения», проверьте сетевое окружение — в некоторых регионах требуется сменить узел.
Ошибки, связанные с API-ключами и правами
При вызове API OpenClaw возвращается код 401 Unauthorized — это означает, что ключ недействителен или истёк. Перейдите в панель управления, сгенерируйте новый ключ и убедитесь, что в коде нет лишних пробелов. Если появляется 403 Forbidden, скорее всего, недостаточно средств на балансе или истёк тариф — достаточно продлить подписку. Некоторые расширенные функции требуют лицензии Professional, при использовании бесплатной версии будет ошибка «недостаточно прав».
Проблемы с прокси-соединением и сетью
Если при подключении к прокси OpenClaw постоянно выводится «Connection Timeout», сначала проверьте локальную сеть, затем убедитесь, что порт прокси не занят другим приложением. При ошибке «SSL Handshake Failed» — вероятно, системное время не синхронизировано. Синхронизируйте время и повторите попытку. Если используется пользовательский узел, проверьте корректность адреса и порта, а также убедитесь, что брандмауэр не блокирует трафик.
Типичные ошибки на стороне сервера
При получении 500 Internal Server Error — это временная неисправность сервера OpenClaw, обычно устраняется через несколько минут. 503 Service Unavailable означает, что текущая нагрузка слишком высока. Рекомендуется снизить частоту запросов или перейти на тариф с более высоким приоритетом. Если код ошибки 429 Too Many Requests — приостановите операции и соблюдайте лимиты скорости.
Сводка практических шагов диагностики
При неопределённой ошибке сначала перезапустите клиент OpenClaw и обновите токен. Просмотрите конкретное описание ошибки в журналах бэкенда, найдите соответствующий код в официальной документации. Присоединяйтесь к сообществу пользователей или обратитесь в техподдержку — предоставьте скриншот ошибки и информацию об аккаунте для ускорения решения. Регулярно обновляйте версию ПО, чтобы избежать несовместимости.
