Skip to main content

​
Windows (WSL2)

Se recomienda usar OpenClaw en Windows mediante WSL2 (se recomienda Ubuntu). La CLI + el Gateway se ejecutan dentro de Linux, lo que mantiene el entorno de ejecución consistente y hace que las herramientas sean mucho más compatibles (Node/Bun/pnpm, binarios de Linux, Skills). Windows nativo puede ser más complicado. WSL2 le ofrece la experiencia completa de Linux — un comando para instalar: wsl --install. Las aplicaciones complementarias nativas para Windows están planificadas.

​
Instalación (WSL2)

​
Gateway

​
Instalación del servicio del Gateway (CLI)

Dentro de WSL2:
O bien:
O bien:
Seleccione Gateway service cuando se le solicite. Reparar/migrar:

​
Avanzado: exponer servicios de WSL en la LAN (portproxy)

WSL tiene su propia red virtual. Si otra máquina necesita acceder a un servicio que se ejecuta dentro de WSL (SSH, un servidor TTS local o el Gateway), debe reenviar un puerto de Windows a la IP actual de WSL. La IP de WSL cambia después de los reinicios, por lo que puede que deba actualizar la regla de reenvío. Ejemplo (PowerShell como Administrador):
Permita el puerto a través del Firewall de Windows (una sola vez):
Actualice el portproxy después de que WSL se reinicie:
Notas:
  • El acceso SSH desde otra máquina apunta a la IP del host de Windows (ejemplo: ssh user@windows-host -p 2222).
  • Los nodos remotos deben apuntar a una URL del Gateway accesible (no 127.0.0.1); use openclaw status --all para confirmar.
  • Use listenaddress=0.0.0.0 para acceso en la LAN; 127.0.0.1 lo mantiene solo local.
  • Si desea que esto sea automático, registre una Tarea programada para ejecutar el paso de actualización al iniciar sesión.

​
Instalación paso a paso de WSL2

​
1. Instalar WSL2 + Ubuntu

Abra PowerShell (Administrador):
Reinicie si Windows lo solicita.

​
2. Habilitar systemd (requerido para la instalación del Gateway)

En su terminal de WSL:
Luego, desde PowerShell:
Vuelva a abrir Ubuntu y luego verifique:

​
3. Instalar OpenClaw (dentro de WSL)

Siga el flujo de Primeros pasos de Linux dentro de WSL:
Guía completa: Primeros pasos

​
Aplicación complementaria de Windows

Aún no tenemos una aplicación complementaria para Windows. Las contribuciones son bienvenidas si desea ayudar a que esto suceda.