Какие частые ошибки возникают в OpenClaw?
Вот список самых распространённых ошибок OpenClaw и способы их решения.
Error: Gateway not found / Cannot connect to gateway. Причина: Gateway не запущен. Решение: выполните openclaw start. Если не помогает — проверьте, не занят ли порт 3000 другим процессом.
Error: Model timeout / Request timed out. Причина: модель не ответила за отведённое время (по умолчанию 120 секунд). Бывает при перегрузке серверов провайдера. Решение: увеличьте таймаут или попробуйте позже. Для Ollama — модель может загружаться в память.
Error: Invalid API key / Authentication failed. Причина: неверный или просроченный API-ключ. Решение: проверьте ключ командой openclaw config get apiKey. Убедитесь, что на аккаунте провайдера есть баланс.
Error: Pairing failed / Webhook error. Причина: мессенджер не может подключиться к Gateway. Решение: проверьте, что Gateway доступен из интернета по HTTPS. Для Telegram: URL вебхука должен быть HTTPS с валидным сертификатом.
Error: Permission denied. Причина: недостаточно прав на файлы или порты. Решение: проверьте права на директорию ~/.openclaw/ и порт Gateway. Не запускайте от root — используйте порт выше 1024.
Error: Skill not found / Skill error. Причина: скилл не установлен, устарел или имеет баг. Решение: переустановите скилл командой openclaw skill install.
Общая диагностика: команда openclaw doctor проверит все компоненты и выведет конкретные рекомендации по исправлению.
# Полная диагностика: openclaw doctor
# Проверка логов на ошибки: openclaw logs --level error
# Проверка, не занят ли порт: lsof -i :3000