Guía de instalación de NemoClaw para Windows | Minería de cajas

NemoClaw no se ejecuta en Windows de forma nativa. Se basa en características del kernel de Linux como Landlock, seccomp y espacios de nombres de red, ninguno de los cuales existe en Windows. Incluso los desarrolladores experimentados han tenido dificultades para que funcione y la documentación oficial sólo es compatible con Ubuntu 22.04 o posterior.

Pero hay una manera. Al utilizar WSL2 (Subsistema de Windows para Linux), puede ejecutar un entorno Ubuntu completo dentro de Windows e instalar NemoClaw dentro de él. Esta guía lo guía en cada paso, desde la instalación de WSL2 y Docker Desktop, hasta la configuración del paso a través de la GPU NVIDIA (el paso que la mayoría de las guías omiten), la ejecución del instalador de NemoClaw y la obtención de la primera respuesta del agente.

También cubrimos los errores de repositorio comunes que probablemente encontrará en el camino y cómo solucionarlos. Todos los comandos son de una sola línea y se pueden copiar y pegar: sin barras invertidas ni canalizaciones de varias líneas. Si prefiere mirar en lugar de leer, el video tutorial completo está vinculado a continuación.

Paso 1: instale WSL2 con Ubuntu

PowerShell (administrador):

wsl --install -d Ubuntu-22.04

Después de reiniciar, en Ubuntu:

sudo apt update && sudo apt upgrade -y

Paso 2: habilite systemd

sudo nano /etc/wsl.conf

Agregar:

[boot]
systemd=true

PowerShell:

wsl --shutdown

Vuelva a abrir Ubuntu, verifique:

systemctl is-system-running

Paso 3: Escritorio Docker

1. Instale Docker Desktop para Windows: https://www.docker.com/products/docker-desktop/
2. Configuración → Recursos → Integración WSL → activar Ubuntu → Aplicar y reiniciar

Verificar en Ubuntu:

docker run hello-world

Paso 4: transferencia de GPU NVIDIA

1. Instale el controlador NVIDIA más reciente para Windows: https://www.nvidia.com/Download/index.aspx
2. NO instale un controlador NVIDIA para Linux dentro de WSL2

En Ubuntu, agregue la clave de firma:

curl -fsSL https://nvidia.github.io/libnvidia-container/gpgkey | sudo gpg --dearmor -o /usr/share/keyrings/nvidia-container-toolkit-keyring.gpg

Agregue repositorio (use la URL del archivo .list, no el directorio simple):

curl -s -L https://nvidia.github.io/libnvidia-container/stable/deb/nvidia-container-toolkit.list | sed 's#deb https://#deb [signed-by=/usr/share/keyrings/nvidia-container-toolkit-keyring.gpg] https://#g' | sudo tee /etc/apt/sources.list.d/nvidia-container-toolkit.list

Instalar:

sudo apt update

sudo apt install -y nvidia-container-toolkit

sudo nvidia-ctk runtime configure --runtime=docker

Reinicie Docker Desktop y luego:

sudo apt install -y nvidia-cuda-toolkit

Verificar (ambos deben funcionar):

nvidia-smi

nvcc --version

Si nvidia-smi falla → actualice el controlador NVIDIA de Windows → wsl --shutdown → reintentar.

Paso 5: Node.js 20+

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

sudo apt install -y nodejs

node -v && npm -v

Paso 6: Instale NemoClaw (CLI + asistente integrado)

curl -fsSL https://nvidia.com/nemoclaw.sh | bash

El asistente se ejecuta automáticamente a través de [1/7] a [7/7]:

• [4/7] — Ingrese su clave API de NVIDIA desde https://build.nvidia.com
• [5/7] — Elija el modelo de nube (predeterminado: nemotron-3-super-120b-a12b)
• [7/7] — Acepte los ajustes preestablecidos de políticas sugeridos (pypi, npm) presionando Y

Después de que termine:

source ~/.bashrc

nemoclaw --version

openshell --version

Paso 7: conectar y probar

Verificar el estado de la zona de pruebas

nemoclaw (sandbox name) status

Conectar:

nemoclaw (sandbox name) connect

Dentro del sandbox, inicia el chat:

openclaw tui

O pruebe a través de CLI:

openclaw agent --agent main --local -m "hello" --session-id test

Salir de la zona de pruebas:

exit

Verifique los registros si algo se siente mal:

nemoclaw boxplant logs --follow

Paso 8: endurecer WSL2

sudo nano /etc/wsl.conf

Configuración completa:

[boot]
systemd=true

[interop]
enabled=false
appendWindowsPath=false

[automount]
enabled=false

PowerShell:

wsl --shutdown

Opcional: límite de memoria (crear %UserProfile%\.wslconfig):

[wsl2]
memory=12GB
swap=8GB

Uso diario

nemoclaw (sandbox name) connect

openclaw tui

Reinicio nuclear (si las cosas se rompen)

openshell sandbox delete (sandbox name)

openshell gateway destroy --name nemoclaw

docker volume rm openshell-cluster-nemoclaw

Luego vuelva a ejecutar curl -fsSL https://nvidia.com/nemoclaw.sh | bash del Paso 6.

Solución alternativa manual (solo si el asistente del paso 6 falla con errores de zona de pruebas)

bashopenshell sandbox delete my-sandbox 2>/dev/null

openshell gateway destroy --name nemoclaw 2>/dev/null

docker volume rm openshell-cluster-nemoclaw 2>/dev/null

openshell gateway start --name nemoclaw

openshell status

openshell provider create --name nvidia-nim --type nvidia --credential NVIDIA_API_KEY=nvapi-YOUR_KEY_HERE

openshell inference set --provider nvidia-nim --model nvidia/nemotron-3-super-120b-a12b

openshell sandbox create --name my-sandbox --from openclaw

openshell sandbox ssh my-sandbox

openclaw onboard

Cuando se le solicite proveedor → seleccione Proveedor personalizado → ingrese https://inference.local/v1

Si se establece la clave antrópica: unset ANTHROPIC_API_KEY