Устранение неполадок

На этой странице рассматриваются распространённые проблемы, которые могут возникнуть при установке, настройке или работе NemoClaw, а также способы их решения.

Tip: Если вашей проблемы нет в этом списке, присоединяйтесь к Discord-каналу NemoClaw, чтобы задать вопросы и получить помощь от сообщества. Вы также можете создать issue на GitHub.

Установка

nemoclaw не найден после установки

Если вы используете nvm или fnm для управления Node.js, установщик может не обновить PATH текущей оболочки. Бинарный файл nemoclaw установлен, но текущая сессия оболочки не знает, где его найти.

Выполните source ~/.bashrc (или source ~/.zshrc для zsh) или откройте новое окно терминала.

Установщик завершается с ошибкой на неподдерживаемой платформе

Установщик проверяет поддерживаемую ОС и архитектуру перед продолжением. NemoClaw требует Linux Ubuntu 22.04 LTS или более позднюю версию. Если вы видите ошибку неподдерживаемой платформы, убедитесь, что вы работаете на поддерживаемом дистрибутиве Linux.

Версия Node.js слишком старая

NemoClaw требует Node.js 20 или более позднюю версию. Если установщик завершается с ошибкой версии Node.js, проверьте текущую версию:

$ node --version

Если версия ниже 20, установите поддерживаемый релиз. Если вы используете nvm, выполните:

$ nvm install 20
$ nvm use 20

Затем повторно запустите установщик.

Docker не запущен

Установщик и мастер настройки требуют запущенного Docker. Если вы видите ошибку подключения к Docker, запустите демон Docker:

$ sudo systemctl start docker

На macOS с Docker Desktop откройте приложение Docker Desktop и дождитесь завершения запуска перед повторной попыткой.

npm install завершается с ошибкой прав доступа

Если npm install завершается с ошибкой EACCES, не выполняйте npm с sudo. Вместо этого настройте npm для использования каталога, которым вы владеете:

$ mkdir -p ~/.npm-global
$ npm config set prefix ~/.npm-global
$ export PATH=~/.npm-global/bin:$PATH

Добавьте строку export в ваш ~/.bashrc или ~/.zshrc для постоянного действия, затем повторно запустите установщик.

Порт уже используется

Шлюз NemoClaw использует порт 18789 по умолчанию. Если другой процесс уже занял этот порт, настройка завершается с ошибкой. Определите конфликтующий процесс, убедитесь, что его безопасно остановить, и завершите его:

$ lsof -i :18789
$ kill <PID>

Если процесс не завершается, используйте kill -9 <PID> для принудительного завершения. Затем повторите настройку.

Настройка

Ошибки cgroup v2 при настройке

На Ubuntu 24.04, DGX Spark и WSL2 Docker может быть не настроен для делегирования cgroup v2. Предварительная проверка при настройке обнаруживает это и завершается с понятным сообщением об ошибке.

Запустите скрипт настройки Spark для исправления конфигурации cgroup Docker, затем повторите настройку:

$ sudo nemoclaw setup-spark
$ nemoclaw onboard

Недопустимое имя песочницы

Имена песочниц должны соответствовать правилам поддоменов RFC 1123: только строчные буквенно-цифровые символы и дефисы, имя должно начинаться и заканчиваться буквенно-цифровым символом. Заглавные буквы автоматически переводятся в строчные.

Если имя не соответствует этим правилам, мастер завершается с ошибкой. Выберите имя, такое как my-assistant или dev1.

Создание песочницы завершается ошибкой на DGX

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

Выполните nemoclaw onboard для повторной попытки. Мастер автоматически очищает устаревшие пробросы портов и ждёт готовности шлюза.

Сокет Colima не обнаружен (macOS)

Новые версии Colima используют базовый каталог XDG (~/.config/colima/default/docker.sock) вместо устаревшего пути (~/.colima/default/docker.sock). NemoClaw проверяет оба пути. Если ни один не найден, убедитесь, что Colima запущен:

$ colima status

Работа

Песочница отображается как остановленная

Песочница могла быть остановлена или удалена. Выполните nemoclaw onboard для пересоздания песочницы из того же блюпринта и определений политик.

Статус показывает «not running» внутри песочницы

Это ожидаемое поведение. При выполнении openclaw nemoclaw status внутри активной песочницы состояние песочницы и конфигурация инференса на стороне хоста недоступны для проверки. Команда status обнаруживает контекст песочницы и сообщает «active (inside sandbox)».

Выполните openshell sandbox list на хосте для проверки базового состояния песочницы.

Запросы инференса завершаются по тайм-ауту

Убедитесь, что эндпоинт провайдера инференса доступен с хоста. Проверьте активного провайдера и эндпоинт:

$ openclaw nemoclaw status

Если эндпоинт правильный, но запросы всё равно не проходят, проверьте правила сетевой политики, которые могут блокировать соединение, и убедитесь, что ваш API key NVIDIA действителен.

Агент не может достичь внешнего хоста

OpenShell блокирует исходящие соединения к хостам, не указанным в сетевой политике. Откройте TUI для просмотра заблокированных запросов и их одобрения:

$ openshell term

Для постоянного разрешения эндпоинта добавьте его в сетевую политику. Обратитесь к Настройке сетевой политики для подробностей.

Запуск блюпринта завершился ошибкой

Просмотрите вывод ошибки для неудачного запуска блюпринта:

$ openclaw nemoclaw logs --run-id <id>

Если идентификатор запуска неизвестен, опустите --run-id для просмотра логов последнего запуска. Используйте --follow для потокового вывода логов в реальном времени при отладке.