Configurar OpenClaw en Windows con WSL2

Configurar herramientas de desarrollo en Windows a veces se siente como una batalla cuesta arriba. Las dependencias fallan o los comandos que ves en los tutoriales no funcionan igual, lo que te quita tiempo para programar. Usar WSL2 resuelve esto al darte un entorno Linux real donde las herramientas funcionan como se espera.

Para correr OpenClaw en Windows, te recomiendo usar WSL2 (preferiblemente con Ubuntu). El CLI y el Gateway se ejecutan dentro de Linux, lo que mantiene el entorno consistente y hace que Node.js, Bun o pnpm sean compatibles de inmediato. Aunque hay planes para apps nativas de Windows, WSL2 es hoy la mejor opción para tener la experiencia completa de Linux con un solo comando: wsl --install.

Requisitos previos

• Windows 10 o 11 con soporte para WSL2.
• Una distribución de Linux instalada (Ubuntu recomendada).
• Conexión a internet para descargar dependencias.

Inicio rápido

Sigue estos pasos para tener OpenClaw funcionando en menos de 5 minutos.

1. Instalar WSL2 y Ubuntu

Abre PowerShell como Administrador y ejecuta:

wsl --install -d Ubuntu-24.04

Reinicia tu computadora si Windows lo solicita.

2. Activar systemd

Es obligatorio para que el Gateway funcione. En tu terminal de Ubuntu, ejecuta:

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

Luego, desde PowerShell, reinicia WSL:

wsl --shutdown

Vuelve a abrir Ubuntu y verifica el estado:

systemctl --user status

3. Instalar OpenClaw

Dentro de la terminal de WSL, clona el repositorio e instala las dependencias:

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard

Gateway

Para instalar el servicio del Gateway dentro de WSL2, puedes usar cualquiera de estos comandos:

openclaw onboard --install-daemon
# O también:
openclaw gateway install
# O:
openclaw configure

Selecciona Gateway service cuando el CLI te lo pregunte.

Exponer servicios a la red local (portproxy)

WSL2 usa una red virtual. Si necesitas que otra máquina acceda al Gateway o a un servidor de SSH dentro de WSL, debes redirigir los puertos desde Windows.

Ejemplo en PowerShell (como Administrador):

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "No se encontró la IP de WSL." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort

No olvides permitir el puerto en el Firewall de Windows:

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

Notas importantes:

• Los nodos remotos deben apuntar a una URL del Gateway que sea alcanzable, no uses 127.0.0.1.
• Usa openclaw status --all para confirmar las direcciones.

Solución de problemas

Si encuentras errores durante la instalación o el servicio no inicia correctamente, usa la herramienta de diagnóstico integrada:

openclaw doctor

Este comando te ayudará a reparar o migrar configuraciones dañadas.

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Gateway runbook
• Configuración detallada
• Guía de actualización