Cómo instalar OpenClaw en Windows (nativo o WSL2)

Para instalar OpenClaw en Windows, abre PowerShell y corre iwr -useb https://openclaw.ai/install.ps1 | iex. Corre nativo, sin WSL2, e instala Node si falta.

Mucha gente cree que OpenClaw en Windows solo funciona dentro de WSL2. No es así: hay tres caminos oficiales y dos son nativos. Esta guía cubre los tres, cuándo conviene cada uno, cómo dejarlo arrancando solo y qué hacer con los fallos que se repiten. Para el resto de plataformas, está la cómo instalar OpenClaw.

Requisitos

• Windows 10 (20H2 o superior) o Windows 11
• Node.js 22.22.3+, 24.15+ o 25.9+. La documentación recomienda Node 26, y el instalador lo resuelve por ti
• Al menos 4 GB de RAM (8 GB para uso intensivo)
• Una API key de tu proveedor de IA

Camino 1: instalador de PowerShell

El más directo, y el que quiere la mayoría. Abre PowerShell y ejecuta:

iwr -useb https://openclaw.ai/install.ps1 | iex

Instala Node si hace falta, deja OpenClaw listo y arranca el onboarding, que te pide API key, puerto del gateway y canales.

Si prefieres instalar ahora y configurar después, la invocación es algo más incómoda de lo que parece, porque hay que reconstruir el script como bloque para poder pasarle el parámetro:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

Después lanzas el asistente cuando quieras con openclaw onboard.

Camino 2: app nativa Windows Hub

La opción de escritorio. Windows Hub es la app companion en WinUI para Windows 10 20H2+ y Windows 11, se instala sin privilegios de administrador y publica instaladores firmados para x64 y ARM64 desde su propia página de releases, separada de la del CLI.

Lo que trae:

• Estado en la bandeja del sistema y arranque al iniciar sesión
• Asistente de primera ejecución que monta un gateway propio en WSL, sin tocar tu Ubuntu existente
• Conexión a gateways locales, remotos o a través de túnel SSH
• Ventana de chat nativa y acceso a la Control UI del navegador
• Command Center con diagnóstico de sesiones, uso, canales, nodos y emparejamiento
• Modo nodo, para que el agente use capacidades nativas de Windows (canvas, pantalla, cámara, notificaciones, voz y ejecución controlada de comandos)
• Modo servidor MCP local, para clientes como Claude Desktop, Claude Code o Cursor

Ese último punto es el más interesante y el que casi nadie menciona: puedes tener Windows Hub exponiendo las capacidades nativas de Windows como servidor MCP en loopback, sin un gateway de OpenClaw corriendo. Si ya trabajas con servidores MCP, es una forma de darle manos en Windows a tu asistente habitual.

En la primera ejecución, la ruta rápida es Set up locally, que aprovisiona una distro WSL propia llamada OpenClawGateway, instala el gateway dentro y empareja la app. Cuando termina, el icono de la bandeja se pone verde.

Camino 3: gateway en WSL2

WSL2 sigue siendo el runtime más compatible con Linux. Windows Hub puede montarlo por ti, o lo instalas a mano:

wsl --install
# o eligiendo distro:
wsl --list --online
wsl --install -d Ubuntu-24.04

Dentro de WSL hay que habilitar systemd, porque sin él no hay servicio:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

Reinicia WSL desde PowerShell con wsl --shutdown y después instala OpenClaw dentro con el camino de Linux, igual que en la guía de OpenClaw en Ubuntu:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw gateway status

Verificar la instalación

openclaw --version
openclaw doctor
openclaw gateway status --json

openclaw doctor es la primera parada ante cualquier problema: te dice qué falta (Node viejo, puerto ocupado, API key sin configurar) en vez de fallar en silencio.

Arranque automático

En los caminos nativos no hay systemd, así que el arranque va por el mecanismo de Windows, y OpenClaw lo gestiona por ti:

openclaw gateway install
openclaw gateway status --json

Usa Tareas programadas cuando están disponibles. El detalle está bien pensado: mantiene un gateway.cmd legible en el directorio de estado, pero lo lanza a través de un envoltorio gateway.vbs, de forma que el gateway en segundo plano no te abra una ventana de consola visible. Si la creación de la tarea queda denegada, cae a un elemento de inicio en la carpeta Startup del usuario.

O sea que no hace falta que armes la tarea a mano. Solo si quieres controlarla tú.

Arranque antes de iniciar sesión, con WSL

Este es el caso peliagudo: un WSL headless que debe levantar aunque nadie inicie sesión en Windows. Dentro de WSL:

sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

Y en PowerShell como administrador:

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Los dos detalles de esa línea son los que fallan si copias recetas viejas:

• dbus-launch true en vez de /bin/true, porque desde WSL 2.6.1.0 hay una regresión que termina la distro entre 15 y 20 segundos después de que salga el último cliente, incluso con linger habilitado. Mantener vivo un proceso hijo de init lo evita.
• /ru "$env:USERNAME" en vez de /ru SYSTEM, porque las distros WSL son por usuario y la cuenta SYSTEM no las ve. La tarea parece ejecutarse y la distro nunca arranca.

Tras reiniciar, verifica desde WSL:

systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

¿Cuál elegir?

En todos los casos, la interfaz de control queda en http://127.0.0.1:18789/.

Problemas frecuentes

No aparece el icono en la bandeja. Busca OpenClaw.Tray.WinUI.exe en el Administrador de tareas. Si está corriendo, abre el área de iconos ocultos y ánclalo. Si no, lanza OpenClaw Companion desde el menú Inicio.

Falla el setup local. El log está en %LOCALAPPDATA%\OpenClawTray\Logs\Setup\easy-setup-latest.txt. Las causas típicas son WSL deshabilitado, virtualización bloqueada, estado viejo de la distro propia de la app, o un fallo de red instalando el paquete.

Dice que hace falta emparejar. Apruébalo desde el host del gateway:

openclaw devices list
openclaw devices approve <requestId>

El chat web no llega a un gateway remoto. El chat remoto necesita HTTPS o localhost. Con certificados autofirmados, confía el certificado en Windows o usa un túnel SSH contra una URL de localhost.

Fallan cámara, captura de pantalla o audio. Revisa los permisos de Windows para cámara, micrófono, captura de pantalla y notificaciones. Aunque la instalación declare esas capacidades, Windows puede pedir confirmación la primera vez.

Si te falta alguna pieza del recorrido, las tengo todas reunidas en la guía de OpenClaw: requisitos, actualizaciones y el resto de plataformas.

Preguntas frecuentes

Cierre

En Windows tienes tres caminos: PowerShell para lo más rápido, Windows Hub para escritorio, modo nodo y MCP local, y WSL2 si quieres el entorno Linux con systemd. Para Docker, Ubuntu o macOS, está la guía completa de OpenClaw.

Si acabas eligiendo la vía de WSL2, todo lo del servidor 24/7 en Ubuntu te sirve tal cual: dentro de WSL2 tienes systemd y el mismo servicio. Y si prefieres aislarlo del sistema anfitrión, la ruta es Docker Compose, que en Windows corre sobre ese mismo WSL2 sin que tengas que administrarlo.

Fuentes

• Windows, documentación oficial de OpenClaw
• Install, documentación oficial de OpenClaw