NemoClaw es la herramienta oficial de NVIDIA para instalar y ejecutar OpenClaw de forma segura dentro de un entorno aislado. Con un solo comando se configura todo el sistema necesario, incluyendo el motor de aislamiento OpenShell, que protege al agente con múltiples capas de seguridad a nivel de núcleo del sistema.

Esta guía cubre cada paso desde cero: desde activar WSL2 en Windows hasta tener un agente de inteligencia artificial respondiendo en la terminal.

⚠️ Advertencia: NemoClaw es software en estado Alpha. Sus interfaces y programas de acceso pueden cambiar sin previo aviso. Según el README oficial: “NemoClaw currently requires a fresh installation of OpenClaw” — no puede reutilizar instalaciones previas de OpenClaw.

¿Qué es NVIDIA NemoClaw y para qué sirve?

NemoClaw es un complemento oficial de NVIDIA para OpenClaw, el marco de agentes de inteligencia artificial autónomos de código abierto. Su diferencia fundamental frente a una instalación manual es que integra automáticamente el motor OpenShell, creando un entorno aislado donde el agente opera sin acceso irrestricto al sistema. Cada solicitud de red, acceso a archivo e inferencia queda sujeta a políticas de seguridad aplicadas directamente en el núcleo de Linux.

NemoClaw cuenta con dos partes diferenciadas: un complemento TypeScript que corre dentro del programa de línea de comandos de OpenClaw bajo el espacio de nombres openclaw nemoclaw, y un binario independiente llamado nemoclaw que maneja la configuración del sistema anfitrión, el despliegue y la gestión de servicios. Ambas partes se instalan juntas al ejecutar npm install -g nemoclaw.

Conceptos clave antes de comenzar

Entender qué hace cada componente evita los errores más frecuentes durante la instalación. La confusión entre herramientas es la causa principal de intentos fallidos.

Componente	Descripción	Dónde corre
OpenClaw	Marco de agentes de inteligencia artificial autónomos (código abierto)	Dentro del entorno aislado Docker
NemoClaw	Complemento oficial de NVIDIA que instala OpenClaw de forma segura	Sistema anfitrión WSL2 (Ubuntu)
OpenShell	Motor de NVIDIA que crea entornos aislados con Landlock + seccomp + espacio de red	Sistema anfitrión WSL2 (Ubuntu)
Entorno aislado	Contenedor seguro donde corre OpenClaw; plano de datos de OpenShell	Dentro de Docker en WSL2
Puerta de enlace	Plano de control que gestiona ciclo de vida, proveedores y políticas de los entornos	Sistema anfitrión WSL2 (Ubuntu)
Nemotron	Modelo de lenguaje de NVIDIA que impulsa el agente	Nube NVIDIA (vía programa de acceso)

Arquitectura de la instalación

Comprender la arquitectura evita confusiones, especialmente si ya tienes OpenClaw instalado en Windows. Ambas instalaciones son completamente independientes y no pueden compartir configuración ni estado.

Windows (sistema anfitrión) ├── WSL2 (subsistema Linux) │ └── Ubuntu 22.04 │ ├── Docker (motor de contenedores) │ ├── Node.js 22+ y npm 10+ (entorno de ejecución JavaScript) │ ├── OpenShell (herramienta de línea de comandos NVIDIA) │ └── NemoClaw (complemento para OpenClaw) │ └── [Al ejecutar nemoclaw onboard] Crea entorno aislado │ └── OpenClaw (instalado automáticamente dentro del entorno) │ └── Agente de IA (Nemotron vía programa de acceso NVIDIA) │ └── [Si existe] OpenClaw instalado directamente en Windows └── ⚠️ INDEPENDIENTE: NemoClaw no puede usar esta instalación

Requisitos previos del sistema

Componente	Requisito mínimo	Recomendado
Sistema operativo	Windows 10 versión 21H2	Windows 11 actualizado
Procesador	Intel VT-x o AMD-V habilitado en BIOS	AMD Ryzen 7 o Intel Core i7 reciente
Tarjeta gráfica	NVIDIA compatible con CUDA	NVIDIA GeForce RTX serie 3000 o superior
Memoria RAM	8 GB	16 GB o más
Almacenamiento	50 GB libres	SSD con 100 GB libres
Conexión a internet	Estable	Banda ancha de 20 Mbps o más
Permisos	Administrador en Windows	—

Paso 0: Verificar y manejar conflictos con instalaciones existentes

Este paso es importante si ya tienes OpenClaw instalado. Saltarlo puede provocar confusión sobre qué versión se está ejecutando y desde dónde.

0.1 Verificar si existe OpenClaw en Windows nativo

Abre PowerShell como administrador y ejecuta:

where openclaw openclaw --version

Si existe una instalación en Windows, considera estas opciones:

Opción	Descripción	Acción requerida
A: Mantener ambas (recomendado)	Usa OpenClaw de Windows para desarrollo local; NemoClaw para entorno seguro en WSL2	Ninguna
B: Desinstalar de Windows	Elimina OpenClaw de Windows para evitar confusión de versiones	winget uninstall OpenClaw o desde el panel de control
C: Renombrar ejecutable	Cambia el nombre del ejecutable en Windows para distinguirlo del de WSL2	Renombrar manualmente en el directorio de instalación

0.2 Verificar instalaciones previas en WSL2

# Verificar OpenClaw en WSL2 which openclaw openclaw --version # Verificar NemoClaw which nemoclaw nemoclaw --version # Verificar entornos aislados existentes openshell sandbox list

0.3 Limpiar una instalación previa fallida (solo si es necesario)

Si realizaste una instalación anterior incompleta o con errores, es fundamental limpiar el estado antes de reintentar. Los intentos fallidos pueden dejar el clúster interno en un estado corrupto que impide nuevas instalaciones.

# Eliminar entorno aislado específico openshell sandbox delete nombre-entorno 2>/dev/null # Destruir la puerta de enlace de NemoClaw openshell gateway destroy --name nemoclaw 2>/dev/null # Eliminar volumen de datos del clúster docker volume rm openshell-cluster-nemoclaw 2>/dev/null # Opción de limpieza total del sistema OpenShell (elimina todo) openshell system reset

⚠️ Atención: Si tuviste un intento fallido previo, ejecutar los tres primeros comandos de limpieza es obligatorio antes de reintentar. Omitir este paso genera errores persistentes de sandbox not found que no se resuelven de otra forma.

Paso 1: Activar WSL2 en Windows

1.1 Abrir PowerShell como administrador

1. Presiona la tecla Windows
2. Escribe PowerShell
3. Clic derecho sobre el resultado → Ejecutar como administrador
4. Confirma el mensaje de Control de Cuentas de Usuario

1.2 Instalar WSL2

wsl --install

Este comando habilita los componentes de virtualización necesarios en Windows, establece WSL2 como versión predeterminada y descarga Ubuntu como distribución base, todo en un solo paso.

1.3 Reiniciar la computadora

Cuando el proceso lo solicite, reinicia tu equipo. Sin reinicio, los componentes de virtualización no quedan activos en el núcleo de Windows.

1.4 Verificar la instalación

wsl --version

Debes ver una salida similar a:

Versión de WSL: 2.4.13.0 Versión de kernel: 6.6.87.2-microsoft-standard-WSL2

1.5 Solución: virtualización deshabilitada en BIOS

Si aparece un error relacionado con virtualización, el procesador tiene esta función deshabilitada en el firmware:

1. Reinicia el equipo y presiona repetidamente F2, F12, DEL o ESC durante el arranque (la tecla varía según el fabricante)
2. Busca la opción Intel VT-x, AMD-V, Virtualization Technology o SVM Mode
3. Cambia el valor a Enabled
4. Guarda con F10 y reinicia
5. Vuelve a ejecutar wsl --install

Paso 2: Instalar Ubuntu 22.04 LTS

2.1 Instalar desde Microsoft Store

1. Abre Microsoft Store desde el menú Inicio
2. Busca Ubuntu 22.04 LTS
3. Haz clic en Instalar
4. Espera la descarga (aproximadamente 500 MB)

💡 ¿Por qué Ubuntu 22.04 y no una versión más reciente? NemoClaw y OpenShell están validados sobre Ubuntu 22.04 LTS. El uso de versiones más recientes puede generar incompatibilidades con dependencias del sistema que aún no han sido actualizadas en los paquetes oficiales de NVIDIA.

2.2 Primer inicio y configuración de usuario

1. Abre Ubuntu 22.04 desde el menú Inicio
2. Espera la instalación inicial (entre 1 y 3 minutos — ocurre solo la primera vez)
3. Cuando aparezca Enter new UNIX username:, crea tu usuario:

Enter new UNIX username: tu-usuario New password: [escribe tu contraseña — no se muestra en pantalla] Retype new password: [confirma]

Ubuntu está listo cuando ves el indicador de comandos con tu nombre de usuario:

tu-usuario@PC:~$

Paso 3: Cambiar a usuario administrador cuando sea necesario

El usuario administrador del sistema tiene permisos completos sobre Linux. Lo necesitarás para instalar paquetes del sistema.

3.1 Cambiar temporalmente al administrador

sudo su

Ingresa tu contraseña. El indicador de comandos cambia de $ a #, indicando modo administrador:

root@PC:/home/tu-usuario#

3.2 Volver al usuario normal

exit

💡 Práctica recomendada: En lugar de permanecer como administrador durante toda la sesión, usa el prefijo sudo antes de comandos individuales que requieran elevación de permisos. Esto reduce el riesgo de modificar accidentalmente archivos del sistema.

 

Paso 4: Instalar Docker en Ubuntu (dentro de WSL2)

Docker es una dependencia obligatoria para NemoClaw. Debe instalarse dentro de Ubuntu WSL2, no en Windows. Docker Desktop para Windows es un producto distinto e incompatible con la arquitectura de OpenShell.

4.1 Actualizar repositorios y paquetes del sistema

sudo apt update && sudo apt upgrade -y

4.2 Instalar dependencias de transporte seguro

sudo apt install -y apt-transport-https ca-certificates curl gnupg lsb-release

4.3 Agregar la clave criptográfica oficial de Docker

sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

4.4 Configurar el repositorio oficial de Docker

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4.5 Instalar Docker y sus componentes

sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4.6 Iniciar Docker y habilitarlo en el arranque

sudo systemctl start docker sudo systemctl enable docker

4.7 Verificar la instalación

sudo docker --version

Debes ver algo similar a: Docker version 28.0.0, build xxxxxxx

4.8 Configurar Docker sin permisos de administrador (recomendado)

Este ajuste permite ejecutar Docker sin anteponer sudo en cada comando, lo cual es necesario para que NemoClaw funcione sin interrupciones de permisos:

sudo usermod -aG docker $USER newgrp docker

Prueba que funciona correctamente:

docker run hello-world

Si ves el mensaje de bienvenida de Docker, la instalación es correcta.

Paso 5: Instalar Node.js 22 y npm

NemoClaw requiere Node.js 20 como mínimo; se recomienda la versión 22 LTS por su ciclo de soporte extendido. El programa de línea de comandos de NemoClaw está construido sobre el ecosistema de Node.js.

5.1 Instalar Node.js 22 LTS

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - sudo apt install -y nodejs

5.2 Verificar versiones instaladas

node --version npm --version

Debes ver v22.x.x para Node.js y 10.x.x o superior para npm.

Paso 6: Instalar NVIDIA OpenShell

OpenShell es el componente de seguridad central del sistema. Gestiona el ciclo de vida completo de los entornos aislados: creación, políticas de red, restricciones del sistema de archivos y filtros de llamadas al sistema. Sin OpenShell, NemoClaw no puede crear entornos seguros.

6.1 Instalar dependencias previas

sudo apt install -y curl git

6.2 Instalar OpenShell

curl -fsSL https://get.openshell.sh | bash

Si el enlace no responde, el instalador oficial está disponible en: https://github.com/NVIDIA/OpenShell

6.3 Verificar la instalación

openshell --version

¿Qué protecciones aplica OpenShell al entorno aislado?

OpenShell aplica cuatro capas de protección simultáneas sobre cada entorno. Vale la pena entenderlas porque explican por qué NemoClaw es más seguro que instalar OpenClaw directamente:

Capa	Qué controla	Cómo funciona
Sistema de archivos	Qué rutas puede leer o escribir el agente	Landlock LSM aplica restricciones a nivel de núcleo del sistema operativo
Red	A qué servidores puede conectarse el agente	Cada conexión saliente se verifica contra destino permitido y ejecutable autorizado; ambos deben coincidir o la conexión se rechaza
Procesos	Qué privilegios tiene el agente	El agente corre sin privilegios; seccomp bloquea llamadas peligrosas al sistema como sudo o setuid
Inferencia	Cómo llegan las solicitudes al modelo	El agente nunca llama directamente a la nube; toda inferencia pasa por el proxy interno de OpenShell en https://inference.local/v1

Paso 7: Obtener tu clave de acceso de NVIDIA

Necesitas una clave de acceso para que el agente pueda usar los modelos de inferencia en la nube de NVIDIA. El plan gratuito incluye créditos suficientes para experimentar.

1. Visita https://build.nvidia.com
2. Crea una cuenta gratuita o inicia sesión
3. Ve a la sección API Keys o haz clic en Get API Key
4. Genera una nueva clave
5. Copia y guarda la clave de inmediato — el sistema la muestra una sola vez

🔐 Seguridad: Guarda tu clave en un gestor de contraseñas o en un archivo de texto local temporal. Nunca la compartas ni la subas a repositorios públicos. La clave tiene el formato nvapi-xxxxxxxxxxxxxxxxxxxx.

Paso 8: Instalar NemoClaw

Este es el paso central de la guía. Un solo comando descarga e instala NemoClaw con todas sus dependencias.

8.1 Método recomendado: instalación vía npm

npm install -g nemoclaw

Este es el método oficial documentado por NVIDIA. Instala tanto el complemento de OpenClaw como el binario independiente nemoclaw.

8.2 Método alternativo: instalación vía script

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

⚠️ Importante: No copies el símbolo $ que aparece al inicio de los comandos en documentación. Es únicamente un indicador visual del indicador de comandos y no forma parte del comando real.

8.3 Verificar la instalación

nemoclaw --version

Paso 9: Configuración inicial con nemoclaw onboard

nemoclaw onboard es el asistente interactivo de primera configuración. Crea la puerta de enlace de OpenShell, registra los proveedores de inferencia, construye la imagen del entorno aislado e instala OpenClaw dentro de él automáticamente.

nemoclaw onboard

9.1 Lo que pedirá el asistente

Paso del asistente	Qué ingresar	Notas
Clave de acceso	Pega tu clave de NVIDIA del Paso 7	Formato: nvapi-xxxx... — se guarda en ~/.nemoclaw/credentials.json
Nombre del entorno aislado	Ejemplo: mi-asistente	Sin espacios ni caracteres especiales
Configuración de seguridad	Acepta las políticas por defecto	Recomendado para principiantes
Proveedor de inferencia	Selecciona NVIDIA Cloud	Usa la clave del paso anterior

9.2 Confirmación de instalación exitosa

Al completar el proceso, verás un resumen similar a este:

────────────────────────────────────────────────── Sandbox mi-asistente (Landlock + seccomp + netns) Model nvidia/nemotron-super-[version] (NVIDIA Cloud API) ────────────────────────────────────────────────── Run: nemoclaw mi-asistente connect Status: nemoclaw mi-asistente status Logs: nemoclaw mi-asistente logs --follow ────────────────────────────────────────────────── [INFO] === Installation complete ===

✅ OpenClaw ya está instalado dentro del entorno aislado. No necesitas instalarlo manualmente — NemoClaw lo hace por completo durante la configuración inicial.

¿Qué hacer si el proceso falla en WSL2 con tarjeta gráfica NVIDIA?

Existe un problema documentado en el repositorio oficial: cuando WSL2 detecta una tarjeta gráfica NVIDIA disponible vía nvidia-smi, el asistente de configuración fuerza el parámetro --gpu tanto en la creación de la puerta de enlace como del entorno aislado. En WSL2 con Docker, la tarjeta gráfica no puede pasarse directamente al clúster interno del motor de puerta de enlace, lo que genera un entorno que aparece como creado pero que inmediatamente queda inoperativo. Cualquier comando posterior devuelve sandbox not found.

Si esto ocurre, sigue el procedimiento manual de recuperación:

# 1. Limpiar estado corrupto — obligatorio antes de reintentar openshell sandbox delete mi-asistente 2>/dev/null openshell gateway destroy --name nemoclaw 2>/dev/null docker volume rm openshell-cluster-nemoclaw 2>/dev/null # 2. Iniciar la puerta de enlace sin forzar tarjeta gráfica openshell gateway start --name nemoclaw # 3. Crear proveedor con tu clave de acceso openshell provider create --name nvidia-nim --type nvidia --credential NVIDIA_API_KEY=nvapi-TU-CLAVE-AQUI # 4. Configurar la ruta de inferencia openshell inference set --provider nvidia-nim --model nvidia/nemotron-super-[version] # 5. Crear entorno aislado sin forzar tarjeta gráfica openshell sandbox create --name mi-asistente --from openclaw

Una vez dentro del entorno aislado, ejecuta openclaw onboard y selecciona Custom Provider con la URL base https://inference.local/v1. No uses la URL real de NVIDIA — el entorno bloquea conexiones salientes directas; toda inferencia debe pasar por el proxy interno de OpenShell.

Problema adicional: gateway en modo incorrecto o entorno contenedor sin systemd

Si al ejecutar openclaw tui dentro del entorno ves gateway disconnected: closed | idle, puede deberse a que la puerta de enlace no está corriendo o está mal configurada. Este escenario ocurre con frecuencia en entornos de contenedor donde systemd no está disponible. Sigue estos pasos en orden:

1. Verificar el estado de la puerta de enlace:

openclaw gateway status

Si muestra systemd user services unavailable, la puerta de enlace debe correr en primer plano — no como servicio del sistema.

2. Corregir el modo y el alcance de red:

openclaw config set gateway.mode local openclaw config set gateway.bind lan

3. Iniciar la puerta de enlace en primer plano:

openclaw gateway run

Deja esta terminal abierta. Deberías ver:

[gateway] listening on ws://0.0.0.0:18789 (PID xxx) [gateway] agent model: anthropic/claude-opus-4-6

4. En una segunda terminal, lanzar la interfaz de conversación:

openclaw tui

⚠️ Importante: La puerta de enlace y la interfaz de conversación deben correr en el mismo entorno — ambas dentro del contenedor o ambas en el sistema anfitrión. Intentar conectar la interfaz de un entorno a la puerta de enlace de otro genera errores de red, conflictos de proxy y bloqueos de seguridad WebSocket que no tienen solución sin cambiar la arquitectura.

Arquitectura correcta dentro del entorno aislado NemoClaw

Sistema anfitrión WSL2 (Ubuntu) ├── openshell gateway (gestiona ciclo de vida del sandbox) └── Docker: sandbox mi-asistente ├── Terminal 1: openclaw gateway run → ws://127.0.0.1:18789 └── Terminal 2: openclaw tui → conecta al gateway local

La puerta de enlace y la interfaz de conversación de OpenClaw deben correr dentro del mismo sandbox, no en el sistema anfitrión.

 

Paso 10: Usar OpenClaw — ciclo de vida completo

10.1 Conectar al entorno aislado

Desde el indicador de comandos normal de Ubuntu:

nemoclaw mi-asistente connect

El indicador cambia para mostrar que ahora operas dentro del entorno aislado:

sandbox@mi-asistente:~$

10.2 Interfaz de conversación interactiva (recomendada para principiantes)

openclaw tui

Se abre una interfaz de conversación en la terminal. Escribe tu mensaje y presiona Enter para enviarlo. El agente Nemotron responderá a continuación.

Atajos de teclado de la interfaz de conversación

Atajo	Función
Ctrl+D	Salir de la interfaz (método correcto)
Ctrl+C	Limpia el texto escrito actualmente — presionar dos veces seguidas también cierra la interfaz
Esc	Aborta la tarea en ejecución actual del agente
Ctrl+L	Abre el selector de modelo
Ctrl+G	Abre el selector de agente
Ctrl+P	Abre el selector de sesión

Comandos de barra disponibles dentro de la interfaz

Escribe estos comandos directamente en el campo de texto de la interfaz:

Comando	Función
/exit	Salir de la interfaz de conversación
/new o /reset	Reiniciar la sesión actual
/status	Ver estado del agente
/models	Listar modelos disponibles
/agents	Listar agentes configurados
/think <nivel>	Controlar profundidad de razonamiento del agente
!comando	Ejecutar un comando del sistema directamente desde la interfaz

10.3 Comandos de línea de comandos directos (sin interfaz interactiva)

# Enviar un mensaje único al agente openclaw agent --agent main --local -m "Hola, explícame qué eres" --session-id prueba-1 # Listar agentes disponibles en el entorno openclaw agent list # Ver estado del agente openclaw agent status

10.4 Opciones avanzadas del comando openclaw tui

# Conectar a un agente y sesión específicos desde el inicio openclaw tui --session main --deliver # Conectar a una sesión de trabajo específica openclaw tui --session nombre-sesion

💡 Cuando se ejecuta desde dentro del directorio de un agente, la interfaz selecciona ese agente automáticamente.

10.5 Comandos del complemento NemoClaw (desde dentro del entorno aislado)

# Ver estado del entorno aislado y configuración de inferencia openclaw nemoclaw status # Ver últimas 50 líneas de registros del entorno openclaw nemoclaw logs # Ver registros en tiempo real openclaw nemoclaw logs -f # Ver registros de una ejecución específica openclaw nemoclaw logs --run-id ID-DE-EJECUCION # Acción rápida desde la interfaz de conversación /nemoclaw status

10.6 Salir y gestionar el entorno aislado correctamente

Acción	Comando	Dónde ejecutar
Salir de la interfaz de conversación	Ctrl+D o escribir /exit	Dentro de la interfaz
Salir del entorno aislado (volver al sistema anfitrión)	exit	Dentro del entorno aislado
Detener servicios auxiliares (Telegram, túnel)	nemoclaw stop	Sistema anfitrión WSL2
Eliminar el entorno aislado permanentemente	nemoclaw mi-asistente destroy	Sistema anfitrión WSL2

⚠️ Distinción importante: nemoclaw stop detiene los servicios auxiliares como el puente de Telegram o el túnel de red — no detiene el entorno aislado. Para eliminar completamente un entorno usa nemoclaw mi-asistente destroy.

Paso 11: Gestión avanzada de entornos

11.1 Crear múltiples entornos aislados independientes

# Iniciar nuevo proceso de configuración para un segundo entorno nemoclaw onboard # Cuando pida nombre, usa un identificador distinto: mi-asistente-2 # Listar todos los entornos registrados con modelo y políticas nemoclaw list # Conectar a un entorno específico nemoclaw mi-asistente-2 connect

11.2 Eliminar un entorno aislado

nemoclaw mi-asistente destroy

⚠️ Atención: Este comando detiene el contenedor del modelo y elimina el entorno del registro. Todos los datos almacenados dentro del entorno se pierden permanentemente.

11.3 Gestionar políticas de red

# Ver políticas disponibles y cuáles están activas nemoclaw mi-asistente policy-list # Agregar una política predefinida al entorno nemoclaw mi-asistente policy-add

11.4 Volver a ejecutar la configuración inicial

Usa nemoclaw onboard para nuevas instalaciones y para recrear un entorno aislado después de cambios en políticas o configuración. Al recrear, los datos en el entorno se pierden.

11.5 Monitoreo de actividad y aprobaciones de red

Cuando OpenClaw intenta conectarse a un servidor no autorizado por las políticas del entorno, la conexión se bloquea y aparece como solicitud pendiente. Puedes gestionarla desde la interfaz de monitoreo:

# Abrir la interfaz de monitoreo de OpenShell desde el sistema anfitrión openshell term

11.6 Actualizar NemoClaw

npm install -g nemoclaw

Flujo de trabajo recomendado para principiantes

1. Abrir Ubuntu 22.04 desde el menú Inicio de Windows ↓ 2. nemoclaw mi-asistente connect (inicia el entorno aislado y OpenClaw automáticamente) ↓ 3. Dentro del entorno: openclaw tui (abre la interfaz de conversación interactiva) ↓ 4. Chatear con el agente Nemotron ↓ 5. Ctrl+D para salir de la interfaz de conversación ↓ 6. exit (salir del entorno aislado, volver al sistema anfitrión) ↓ 7. [Opcional] nemoclaw mi-asistente destroy (solo si deseas eliminar el entorno y liberar recursos)

Referencia rápida de comandos

Acción	Comando	Dónde ejecutar
Instalar NemoClaw	npm install -g nemoclaw	Sistema anfitrión WSL2
Configuración inicial	nemoclaw onboard	Sistema anfitrión WSL2
Listar entornos registrados	nemoclaw list	Sistema anfitrión WSL2
Conectar a entorno	nemoclaw mi-asistente connect	Sistema anfitrión WSL2
Interfaz de conversación	openclaw tui	Dentro del entorno aislado
Salir de la interfaz	Ctrl+D o /exit	Dentro de la interfaz
Mensaje único sin interfaz	openclaw agent --agent main --local -m "..."	Dentro del entorno aislado
Ver estado del entorno	nemoclaw mi-asistente status	Sistema anfitrión WSL2
Ver registros en tiempo real	nemoclaw mi-asistente logs --follow	Sistema anfitrión WSL2
Ver políticas de red	nemoclaw mi-asistente policy-list	Sistema anfitrión WSL2
Monitoreo de red	openshell term	Sistema anfitrión WSL2
Salir del entorno aislado	exit	Dentro del entorno aislado
Eliminar entorno	nemoclaw mi-asistente destroy	Sistema anfitrión WSL2
Iniciar servicios auxiliares	nemoclaw start	Sistema anfitrión WSL2
Detener servicios auxiliares	nemoclaw stop	Sistema anfitrión WSL2

Solución de problemas frecuentes

¿Por qué aparece “docker: command not found”?

Docker no está instalado o el servicio no está activo. Repite el Paso 4 completo y verifica el estado del servicio:

sudo systemctl status docker

¿Por qué aparece “node: command not found”?

Node.js no se instaló correctamente. Repite el Paso 5 y verifica:

node --version

“openclaw: command not found” dentro del entorno aislado

El entorno no se inició correctamente o la instalación interna de OpenClaw está incompleta. Sigue estos pasos en orden:

exit nemoclaw mi-asistente status nemoclaw mi-asistente destroy nemoclaw onboard

“gateway disconnected: closed | idle” en la interfaz de conversación

La puerta de enlace no está corriendo o fue iniciada en el entorno equivocado. Desde dentro del entorno aislado:

openclaw config set gateway.mode local openclaw config set gateway.bind lan openclaw gateway run

Deja esa terminal abierta y abre una segunda sesión en el mismo entorno para ejecutar openclaw tui.

“Gateway start blocked: set gateway.mode=local”

La puerta de enlace está configurada en modo remoto pero se intenta iniciar de forma local. Corrige el modo:

openclaw config set gateway.mode local

“port is already allocated” al iniciar el contenedor

Otro contenedor de OpenShell ocupa el puerto necesario. Identifica cuál y detenlo antes de reintentar:

docker ps | grep 8080 docker stop nombre-del-contenedor-en-conflicto

La interfaz de conversación conecta pero sigue mostrando “disconnected”

La puerta de enlace y la interfaz están corriendo en entornos distintos. La puerta de enlace debe estar activa dentro del mismo sandbox donde se ejecuta la interfaz. No es posible conectar la interfaz de un contenedor a la puerta de enlace de otro sin configuración avanzada de red.

Conflicto con OpenClaw de Windows (ruta de ejecución incorrecta en WSL2)

Si el comando openclaw dentro de WSL2 apunta a la instalación de Windows, verifica la ruta del ejecutable:

which openclaw

Si el resultado apunta a /mnt/c/..., estás usando la versión de Windows dentro de WSL2. Edita ~/.bashrc y elimina las referencias a esa ruta, o cierra Ubuntu y vuelve a abrirlo con una sesión limpia.

El agente no responde o agota el tiempo de espera

1. Verifica que la tarjeta gráfica es detectada: nvidia-smi
2. Verifica que la clave de acceso sigue siendo válida en https://build.nvidia.com
3. Revisa los registros del agente: openclaw nemoclaw logs
4. Elimina y recrea el entorno: nemoclaw mi-asistente destroy y luego nemoclaw onboard

“sandbox not found” después de una configuración fallida

Este error indica estado corrupto del clúster interno. La única solución es ejecutar la limpieza completa del Paso 0.3 antes de reintentar. No es posible recuperar un entorno en este estado sin limpiar primero.

Acceso denegado al descargar imágenes del modelo

Si durante el proceso de configuración aparece un error de acceso denegado al descargar la imagen del contenedor desde nvcr.io, el problema puede no ser una clave inválida sino restricciones de permisos en la organización de NVIDIA NGC. En ese caso:

1. Verifica en https://build.nvidia.com que tu cuenta tiene acceso al modelo seleccionado
2. Intenta con un modelo diferente durante el proceso de configuración
3. Revisa los registros completos: nemoclaw mi-asistente logs --follow

“$: command not found” al pegar comandos

Causa: Copiaste el símbolo $ del indicador de comandos, que es solo un marcador visual.

❌ Incorrecto: $ npm install -g nemoclaw ✅ Correcto: npm install -g nemoclaw

Lista de verificación final

• ☐ WSL2 activado en Windows (wsl --version muestra versión 2 o superior)
• ☐ Ubuntu 22.04 instalado y usuario personal creado
• ☐ sudo su funciona sin errores
• ☐ Docker instalado y activo (docker --version)
• ☐ Docker funciona sin permisos de administrador (docker run hello-world)
• ☐ Node.js 22 instalado (node --version muestra v22 o superior)
• ☐ npm 10 instalado (npm --version muestra 10 o superior)
• ☐ OpenShell instalado (openshell --version)
• ☐ Clave de acceso de NVIDIA obtenida y guardada de forma segura
• ☐ NemoClaw instalado (npm install -g nemoclaw)
• ☐ Configuración inicial completada sin errores (nemoclaw onboard)
• ☐ Entorno aislado visible en la lista (nemoclaw list)
• ☐ Primer mensaje enviado al agente vía openclaw tui
• ☐ Salida correcta de la interfaz con Ctrl+D o /exit

Recursos oficiales

• Documentación NemoClaw: https://docs.nvidia.com/nemoclaw/latest/
• Referencia de comandos NemoClaw: https://docs.nvidia.com/nemoclaw/latest/reference/commands.html
• NemoClaw en GitHub: https://github.com/NVIDIA/NemoClaw
• Documentación OpenShell: https://docs.nvidia.com/openshell/latest/
• OpenShell en GitHub: https://github.com/NVIDIA/OpenShell
• Documentación OpenClaw: https://docs.openclaw.ai
• Portal de acceso NVIDIA: https://build.nvidia.comwhiuch