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

Mucha gente cree que OpenClaw en Windows solo corre dentro de WSL2. No es así: hoy tiene tres caminos oficiales, dos de ellos nativos. Esta guía cubre los tres y cuándo conviene cada uno; para el resto de plataformas, está la guía de instalación de OpenClaw.

Requisitos

• Windows 10 (20H2 o superior) o Windows 11
• Node.js 22.19+ (la documentación recomienda Node 24); 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 (recomendado)

El más directo. Abre PowerShell y ejecuta:

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

El script instala Node si hace falta, deja OpenClaw listo y arranca el onboarding (API key, puerto del gateway, canales). Corre nativo, sin WSL2.

Si prefieres instalar primero y configurar después, agrega el flag para saltarte el onboarding:

iwr -useb https://openclaw.ai/install.ps1 | iex -Args "--no-onboard"

Más tarde lanzas el asistente cuando quieras con openclaw onboard.

Camino 2: app nativa Windows Hub

Para usuarios de escritorio, la documentación oficial ofrece la app nativa Windows Hub, que incluye setup, estado en la bandeja del sistema (tray), chat, modo nodo y modo MCP local. Es la opción más cómoda si prefieres una interfaz gráfica en vez de la línea de comandos.

Camino 3: gateway en WSL2

Si ya trabajas en WSL2 y quieres el entorno Linux (con el daemon systemd y todo), instala una Ubuntu dentro de WSL2 y sigue el camino Linux: es idéntico al de la guía de OpenClaw en Ubuntu. Esta vía es la que conviene si quieres tratar OpenClaw como un servicio de servidor.

Dentro de WSL2, el daemon se registra con el mismo flujo de Linux:

openclaw gateway install   # registra el servicio (systemd dentro de WSL2)
openclaw gateway status    # confirma que quedó activo

Ten en cuenta que el systemd de WSL2 no arranca solo al iniciar Windows: necesitas WSL en modo systemd activado y, en la práctica, abrir la distro para que el servicio levante.

Verificar la instalación

Sin importar el camino que elijas, confirma que quedó bien antes de seguir. OpenClaw trae un comando de diagnóstico que revisa Node, permisos, el gateway y la configuración:

openclaw --version          # versión instalada
openclaw doctor             # diagnóstico completo del entorno
openclaw gateway status     # ¿está corriendo el gateway?

openclaw doctor es tu primera parada ante cualquier problema: te dice qué falta (una versión de Node vieja, un puerto ocupado, una API key sin configurar) en vez de fallar en silencio.

Arranque automático en Windows

En los caminos nativos (PowerShell y Windows Hub), OpenClaw no usa systemd, así que el arranque automático va por el mecanismo de Windows. La opción más confiable es una Tarea programada que se dispare al iniciar sesión:

1. Abre el Programador de tareas (Task Scheduler).
2. Crea una tarea básica con disparador Al iniciar sesión.
3. Como acción, lanza openclaw gateway (o el ejecutable que indique tu instalación).

Si no quieres tocar el Programador de tareas, una alternativa simple es dejar un acceso directo a ese comando en la carpeta Inicio (shell:startup). La Tarea programada es preferible porque sobrevive cierres de sesión y permite reintentos.

¿Cuál elegir?

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

Preguntas frecuentes

Cierre

En Windows tienes tres caminos: PowerShell para lo más rápido, la app Windows Hub para una experiencia gráfica, y WSL2 si quieres el entorno Linux. Para Docker, Ubuntu o macOS, está la guía completa de OpenClaw.

Fuente

• Documentación oficial de OpenClaw — instalación