Cómo usar Windows con WSL para ejecutar OpenClaw
Si quieres ejecutar OpenClaw en Windows, la forma más recomendable es hacerlo mediante WSL2 (Windows Subsystem for Linux).
Nota: OpenClaw hasta el 27 de enero de 2026 se denominaba Clawdbot y durante unos días Moltbot.
En pocas palabras: WSL te permite ejecutar Linux dentro de Windows, lo cual es ideal para herramientas como OpenClaw, que están pensadas para funcionar de manera más estable en un entorno Linux (Node/Bun/pnpm, binarios Linux y dependencias típicas del ecosistema).
¿Qué es WSL y por qué es útil para OpenClaw?
WSL (Windows Subsystem for Linux) es una funcionalidad de Windows que permite instalar y ejecutar una distribución Linux (como Ubuntu) sin necesidad de crear una máquina virtual completa ni reiniciar el equipo en otro sistema operativo.
Para OpenClaw, esto es especialmente útil porque:
- El comportamiento de las herramientas y dependencias es más consistente en Linux
- La compatibilidad suele ser mejor que en instalaciones nativas de Windows
- Es más fácil ejecutar servicios tipo “daemon” o gateway en segundo plano
Instalar WSL2 y Ubuntu
- Abre PowerShell como Administrador
- Ejecuta:
wsl--install
Si prefieres instalar una distribución concreta (recomendado Ubuntu 24.04):
wsl--list--onlinewsl--install-dUbuntu-24.04
En algunos casos Windows pedirá reiniciar. Hazlo y, después, abre Ubuntu desde Windows Terminal.
Activar systemd dentro de WSL (recomendado)
Para ejecutar servicios en segundo plano dentro de WSL (como el Gateway), conviene activar systemd.
Desde Ubuntu (WSL), ejecuta:
sudotee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF
Después, desde PowerShell:
wsl--shutdown
Vuelve a abrir Ubuntu y comprueba que está activo:
systemctl --user status
Instalar OpenClaw dentro de WSL
Opción A: Instalación rápida (recomendada)
En Ubuntu (WSL), ejecuta:
curl-fsSL https://clawd.bot/install.sh | bash
Ejecutar el onboarding (configuración inicial)
Una vez instalado, el siguiente paso es lanzar el asistente de configuración:
openclaw onboard
Este proceso configura los elementos clave como el Gateway, canales y credenciales del proveedor.
Instalar el Gateway como servicio en segundo plano
Lo ideal es que el Gateway se ejecute como servicio para evitar tener que levantarlo manualmente cada vez.
Puedes hacerlo con cualquiera de estas opciones:
openclaw onboard --install-daemon
o:
openclaw gateway install
o:
openclaw configure
Y si necesitas validar que todo esté correcto:
openclaw doctor
Cómo se trabaja “Windows + WSL” en el día a día
A partir de aquí, tu flujo habitual será:
- Abrir Windows Terminal
- Entrar en Ubuntu (WSL)
- Ejecutar los comandos de OpenClaw desde Linux
También puedes usar herramientas como:
- Visual Studio Code con la extensión “Remote – WSL”
- Acceder a tus archivos de Windows desde WSL mediante:
/mnt/c/...(por ejemplo/mnt/c/Users/TuUsuario/)
Exponer el Gateway a tu red local (opcional)
WSL funciona en una red virtual, así que si quieres que otros dispositivos (móvil, otro PC, etc.) accedan al servicio, puede ser necesario reenviar puertos.
Ejemplo de reenvío de un puerto (PowerShell como administrador):
$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
Y abrir el puerto en Firewall:
New-NetFirewallRule-DisplayName"WSL SSH 2222"-DirectionInbound `-ProtocolTCP-LocalPort2222-ActionAllow
Este enfoque aplica a cualquier servicio que corra dentro de WSL y deba ser accesible desde fuera.
Problemas típicos y cómo resolverlos
Si algo no funciona como debería, prueba estos comandos:
En Ubuntu (WSL):
openclaw doctor
En PowerShell:
wsl--shutdown
Y vuelve a abrir Ubuntu para reiniciar el entorno.
Conclusión
Si trabajas en Windows y quieres una experiencia estable al ejecutar OpenClaw, WSL2 es tu mejor aliado. Te permite disfrutar de un entorno Linux real, con compatibilidad robusta y una configuración relativamente sencilla.
En pocos pasos puedes dejar instalado:
- WSL2 + Ubuntu
- OpenClaw dentro de WSL
- Gateway funcionando como servicio en segundo plano
Y desde ahí, operar como si estuvieras en Linux… pero sin renunciar a Windows.
Puedes encontrar información sobre la instalación de Linux en Windows con WSL aquí.
