OpenClaw — это инструмент с открытым исходным кодом для настройки и управления AI-агентами. Однако на практике пользователи часто сталкиваются с ошибками запуска или сбоями подключения прокси. В этой статье разобраны самые распространённые коды ошибок и их причины, а также приведены проверенные шаги для восстановления нормальной работы OpenClaw.
Запуск не удаётся: ошибки конфигурации и отсутствие зависимостей
Если OpenClaw при запуске выдаёт сообщение «config.json parse error» или «missing required field», обычно это связано с неправильным форматом файла конфигурации или отсутствием обязательных параметров. Проверьте, содержит ли файл config.json обязательные поля: api_key, model_endpoint и proxy_mode. Используйте инструмент проверки JSON, чтобы убедиться в отсутствии лишних запятых или непарных кавычек. Если появляется ошибка «dependency not found», значит не установлены необходимые пакеты Python — выполните pip install -r requirements.txt.
Некоторые пользователи в Windows также сталкиваются с ошибкой «permission denied». Это происходит потому, что OpenClaw требуется доступ к системным настройкам прокси. Запустите терминал от имени администратора или проверьте, не блокирует ли антивирус прослушивание портов.
Ошибка подключения прокси: занятый порт и конфликты сетевых прокси
Когда OpenClaw сообщает «port already in use», это означает, что порт по умолчанию (например, 8080) уже занят другой программой. Используйте lsof -i :8080 (Linux/macOS) или netstat -ano | findstr 8080 (Windows), чтобы найти и завершить процесс, или укажите другой порт при запуске, добавив флаг --port 8081. Если возникает ошибка «connection refused», проверьте правильность адреса и порта целевого AI-сервиса, а также убедитесь, что локальный брандмауэр разрешает соединение.
Для пользователей, работающих через системный прокси, OpenClaw может некорректно маршрутизировать трафик между внутренней и внешней сетью. Рекомендуется установить proxy_mode в значение exclusive или direct в файле config.json, чтобы избежать вложенности прокси.