Ошибки OpenClaw и их решение: FAQ по проблемам

OpenClaw — мощный инструмент, но как и любое программное обеспечение, он может столкнуться с проблемами. В этой статье мы собрали самые распространённые ошибки и пошаговые инструкции по их решению. Используйте эту статью как справочник — найдите свою ошибку в оглавлении и перейдите к решению.

Ошибки при установке

«Node.js не найден» / «npm не распознана»

Причина: Node.js не установлен или не добавлен в PATH.

Решение:

Скачайте Node.js с nodejs.org (версия LTS)
При установке убедитесь, что галочка «Add to PATH» включена
Перезапустите терминал после установки
Проверьте: node --version должно показать версию

Альтернатива: используйте AI Magic Hub — он не требует Node.js.

Windows SmartScreen блокирует exe-файл

Причина: программа ещё не набрала «репутацию» в системе Microsoft.

Решение: нажмите «Подробнее» → «Выполнить в любом случае». Файл безопасен.

Антивирус удаляет файлы OpenClaw

Причина: ложное срабатывание (false positive).

Решение: добавьте папку установки AI Magic Hub в исключения антивируса. Путь по умолчанию: C:\Program Files\AI Magic Hub.

Ошибка «EACCES permission denied»

Причина: нет прав на установку глобальных npm-пакетов.

Решение: запустите PowerShell от имени администратора и повторите установку.

Ошибки API и моделей

«API key invalid» / «Invalid API key»

Причина: неправильный API-ключ.

Решение:

Проверьте, что ключ скопирован полностью (без лишних пробелов)
Убедитесь, что ключ активен в панели провайдера
Для Anthropic ключ начинается с sk-ant-
Для OpenAI — с sk-
Создайте новый ключ, если старый не работает

Подробнее — в статье как получить API-ключ для OpenClaw.

«Rate limit exceeded» / «Too many requests»

Причина: превышен лимит запросов к API.

Решение:

Подождите 1–2 минуты и повторите
Переключитесь на другую модель временно
Увеличьте лимиты в панели провайдера (может потребоваться повышение тарифа)

«Insufficient funds» / «Payment required»

Причина: закончился баланс на аккаунте API-провайдера.

Решение: пополните баланс. Через AI Magic Hub — в рублях, российской картой.

«Model not found» / «Invalid model»

Причина: указана несуществующая модель.

Решение: проверьте название модели в настройках. Актуальные названия: claude-sonnet-4-20250514, gpt-4o, gemini-2.0-flash.

«Connection timeout» / «Network error»

Причина: проблемы с интернет-соединением или блокировка API.

Решение:

Проверьте подключение к интернету
Если API заблокирован провайдером — используйте VPN
Или используйте AI Magic Hub — он маршрутизирует запросы через свои серверы

Ошибки Telegram-бота

Бот не отвечает на сообщения

Причины и решения:

OpenClaw не запущен на компьютере → запустите AI Magic Hub
Неправильный токен бота → скопируйте заново из @BotFather
Ваш Telegram ID не в списке разрешённых → добавьте в allowedUsers
Компьютер в спящем режиме → разбудите компьютер

Бот отвечает с большой задержкой

Причина: медленная AI-модель или перегрузка API.

Решение: переключитесь на более лёгкую модель (Haiku или Flash). Подробнее — в статье AI-бот в Telegram.

Бот присылает ошибки вместо ответов

Причина: обычно — проблема с API-ключом или балансом.

Решение: проверьте баланс и ключ. Если всё в порядке — обновите OpenClaw до последней версии.

Ошибки при работе агента

Агент «зависает» на задаче

Причина: слишком сложная задача или бесконечный цикл.

Решение:

Отмените задачу (Ctrl+C в терминале или кнопка «Стоп» в AI Magic Hub)
Разбейте задачу на более мелкие шаги
Сформулируйте запрос конкретнее

Агент делает не то, что просили

Причина: нечёткая формулировка задачи.

Решение:

Опишите задачу максимально конкретно
Укажите ожидаемый результат
Используйте примеры: «как в прошлый раз» или «в формате X»
Переключитесь на более мощную модель (Opus вместо Haiku)

«Permission denied» при работе с файлами

Причина: OpenClaw не имеет доступа к запрашиваемой папке.

Решение:

Проверьте рабочую директорию агента
Запустите AI Magic Hub от имени администратора (если нужен доступ к системным папкам)
Переместите файлы в рабочее пространство агента

Общие советы по устранению проблем

Обновите OpenClaw — многие ошибки уже исправлены в новых версиях. Инструкция — в статье как обновить OpenClaw
Перезапустите программу — классическое решение, которое часто помогает
Проверьте логи — в AI Magic Hub: «Настройки» → «Логи». В терминале: файлы в ~/.openclaw/logs/
Очистите кэш — удалите временные файлы: ~/.openclaw/cache/
Переустановите — крайняя мера. Ваши данные в workspace сохранятся

💡 Совет: если проблема повторяется — запишите точный текст ошибки и шаги для воспроизведения. Это поможет при обращении в поддержку.

Меньше ошибок с AI Magic Hub

AI Magic Hub автоматически решает большинство технических проблем: обновления, ключи, маршрутизация.

Скачать AI Magic Hub