OpenClawSkills
GitHub
Plataformas • 7 min de lectura

Windows (WSL2)

Ejecutar OpenClaw en Windows vía WSL2

En Windows, recomendamos ejecutar OpenClaw vía WSL2 (Ubuntu recomendado). El CLI + Gateway se ejecutan dentro de Linux, manteniendo el runtime consistente y mejorando enormemente la compatibilidad de toolchain (Node/Bun/pnpm, binarios Linux, skills, etc). Ejecutar nativamente en Windows suele ser más trabajo; WSL2 te da un entorno Linux completo—instálalo con un comando: wsl --install.

Una app companion nativa de Windows está planificada.

Tutorial.step

Instalar (WSL2)

- Primeros Pasos (ejecutar dentro de WSL)

- Instalar y Actualizar

- Guía de instalación WSL de Microsoft

Tutorial.step

Gateway

- Runbook de Gateway

- Configuración

Tutorial.step

Instalar servicio Gateway (CLI)

Dentro de WSL2:

Terminal
openclaw onboard --install-daemon

O:

Terminal
openclaw gateway install

O:

Terminal
openclaw configure

Cuando se solicite, elige Servicio Gateway.

Reparar / migrar:

Terminal
openclaw doctor
Tutorial.step

Avanzado: exponer servicios WSL a LAN (portproxy)

WSL usa una red virtual separada. Si necesitas que otra máquina alcance un servicio ejecutándose dentro de WSL (SSH, un servicio TTS local, o el Gateway), debes reenviar un puerto de Windows a la IP actual de WSL. La IP de WSL cambia después de un reinicio, así que puede que necesites refrescar la regla de portproxy.

Ejemplo (ejecutar PowerShell como Administrador):

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

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL IP not found." }

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

Permitir a través del Firewall de Windows (una vez):

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

Refrescar portproxy después de que WSL reinicia:

Powershell
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null

Notas:

- Al hacer SSH desde otra máquina, conéctate a la IP del host Windows (ej. ssh user@windows-host -p 2222).

- Los nodos remotos deben apuntar a una URL de Gateway alcanzable (no 127.0.0.1); verifica con openclaw status --all.

- listenaddress=0.0.0.0 expone a LAN; 127.0.0.1 es solo local.

- Para automatizar, registra una tarea programada para ejecutar los pasos de refresco al iniciar sesión.

Tutorial.step

Configuración WSL2 (paso a paso)

Sigue estos pasos para instalar WSL2 + Ubuntu y configurar OpenClaw.

Tutorial.step

1) Instalar WSL2 + Ubuntu

Abre PowerShell (Administrador):

Powershell
wsl --install

wsl --list --online
wsl --install -d Ubuntu-24.04

Si Windows te pide reiniciar, reinicia como se indica.

Tutorial.step

2) Habilitar systemd (requerido para instalación de servicio Gateway)

En la terminal WSL:

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

Luego en PowerShell:

Powershell
wsl --shutdown

Reabre Ubuntu y verifica:

Bash
systemctl --user status
Tutorial.step

3) Instalar OpenClaw dentro de WSL

Dentro de WSL, sigue el flujo de Linux Primeros Pasos:

Bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # First run will auto-install UI dependencies
pnpm build
openclaw onboard

Guía completa: Primeros Pasos

Tutorial.step

App companion de Windows

Aún no hay app companion de Windows. Las contribuciones son bienvenidas.