Как настроить NVIDIA NemoClaw с OpenClaw и исправить ошибки Docker Gateway

Фреймворк NVIDIA NemoClaw позволяет запускать автономных AI-агентов OpenClaw в защищенных песочницах Docker с прямым доступом к графическим ускорителям GeForce RTX и системам DGX. При первичной инициализации в Ubuntu 24.04 и WSL2 пользователи часто сталкиваются с ошибками шлюза Docker Driver Gateway, блокировками портов и сбоями разрешения DNS.

В этой практической инструкции подробно разобран процесс развертывания NemoClaw, правильная настройка переменных окружения и методы быстрого устранения типичных сетевых конфликтов.

NVIDIA NemoClaw представляет собой инфраструктурный слой для изолированного запуска автономных агентов разработки (таких как OpenClaw, Hermes и LangChain Deep Agents). Архитектура решения опирается на связку локального демона Docker, шлюза OpenShell и среды выполнения NVIDIA Container Toolkit. Развертывание в современных дистрибутивах Linux (включая Ubuntu 24.04 LTS) и подсистеме WSL2 на Windows 11 может сопровождаться ошибками инициализации сетевого моста, сбоями маршрутизации DNS и блокировками занятых портов.

Системные требования и предварительная подготовка

Перед установкой убедитесь, что рабочая станция соответствует минимальным спецификациям фреймворка:

• Среда выполнения: Node.js версии 22.19 или новее (рекомендуется установка через nvm или fnm).
• Контейнеризация: Docker Engine 26+ с настроенным доступом текущего пользователя к сокету /var/run/docker.sock.
• Графический стек: Проприетарные драйверы NVIDIA ветки 550+ с установленным пакетом nvidia-container-toolkit.
• Операционная память: От 16 ГБ RAM (при сборке локальных образов агентов из исходников может потребоваться увеличение лимита Node.js heap).

Для добавления прав пользователя к Docker выполните команду и перезайдите в сессию:

sudo usermod -aG docker vitalii

Установка и первый запуск NemoClaw

Установка пакета выполняется глобально через npm или менеджер версий Node.js:

npm install -g @nvidia/nemoclaw

Если после завершения команды терминал сообщает nemoclaw: command not found, добавьте каталог пользовательских бинарных файлов в переменную PATH:

export PATH="/home/vitalii/.local/bin:/home/vitalii/.gemini/antigravity-cli/bin:/home/vitalii/google-cloud-sdk/bin:/home/vitalii/.local/bin:/home/vitalii/.local/bin:/home/vitalii/.local/share/JetBrains/Toolbox/apps/android-studio/jbr/bin:/home/vitalii/.local/go/bin:/home/vitalii/.nvm/versions/node/v24.13.0/bin:/home/vitalii/.local/bin:/home/vitalii/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:/home/vitalii/.local/share/JetBrains/Toolbox/scripts:/home/vitalii/.local/go/bin:/home/vitalii/Android/Sdk/emulator:/home/vitalii/Android/Sdk/platform-tools"

Для запуска мастера первичной инициализации выполните:

nemoclaw init

Устранение ошибки «Docker Driver Gateway Reports a Missing Migration»

Сбой инициализации шлюза Docker Driver Gateway происходит, когда контейнер OpenShell не может применить схему миграции состояния из-за конфликта сетевого порта или незавершенного предыдущего процесса онбординга.

1. Проверьте статус запущенных контейнеров агента:
   docker ps -a --filter "name=nemoclaw"
2. Освободите зависшее окружение с явным указанием порта шлюза:
   NEMOCLAW_GATEWAY_PORT=18789 nemoclaw uninstall
3. Если порт 18789 занят другим сервисом или SSH-туннелем, назначьте свободный порт через переменную окружения перед повторным запуском:
   export NEMOCLAW_GATEWAY_PORT=18795
nemoclaw init

Решение проблем с DNS и доступом к registry.npmjs.org

В закрытых корпоративных сетях и при использовании резолверов systemd-resolved или dnsmasq контейнеры песочниц могут терять доступ к внешним реестрам пакетов при сборке плагинов OpenClaw.

Для восстановления корректной маршрутизации DNS в Docker отредактируйте конфигурационный файл /etc/docker/daemon.json, добавив надежные DNS-серверы:

{ "dns": ["1.1.1.1", "8.8.8.8"] }

После сохранения изменений перезапустите службу Docker:

sudo systemctl restart docker

Настройка GPU Passthrough и интеграции в WSL2

При развертывании NemoClaw внутри WSL2 на Windows 11 необходимо убедиться, что подсистема корректно видит видеокарту и CDI-устройства NVIDIA:

• Проверьте видимость GPU внутри WSL2 командой nvidia-smi.
• Убедитесь, что в конфигурационном файле /etc/nvidia-container-runtime/config.toml включена поддержка CDI (Container Device Interfaces).
• При ошибке unresolvable CDI devices nvidia.com/gpu=all перегенерируйте спецификацию устройств командой sudo nvidia-ctk cdi generate --output=/etc/cdi/nvidia.yaml.

После применения параметров песочница NemoClaw запускает автономного агента OpenClaw в изолированном сетевом пространстве с полным доступом к тензорным ядрам для локального инференса моделей.

Источники

• NVIDIA NemoClaw Troubleshooting Guide, 2026-08-16
• NVIDIA NemoClaw Quickstart with OpenClaw, 2026-08-16