OpenClaw se ha convertido en una herramienta potente para la automatización, pero su ejecución nativa en Windows puede presentar fricciones. La solución más robusta es utilizar el Subsistema de Windows para Linux (WSL2). En esta guía, cubrimos el proceso desde la instalación hasta el acceso remoto.
¿Por qué WSL2?
Ejecutar OpenClaw sobre WSL2 no es solo una cuestión de preferencia. Ofrece tres ventajas críticas:
1 Compatibilidad Nativa: OpenClaw está diseñado para entornos basados en Unix. WSL2 proporciona un kernel de Linux real.
2 Rendimiento: El manejo de archivos y la ejecución de procesos de Node.js es significativamente más rápido en WSL2 que en el sistema de archivos estándar de Windows.
3 Aislamiento: Mantiene las dependencias de desarrollo fuera de su instalación principal de Windows, evitando conflictos de software.
Requisitos previos
- Windows 10 (versión 2004 o superior) o Windows 11.
- Conexión a internet estable.
- Terminal de Windows (recomendado).
Paso 1: Habilitar WSL2
Abra PowerShell como administrador y ejecute:
wsl --install
Reinicie su computadora. Por defecto, esto instalará Ubuntu. Una vez reiniciado, configure su nombre de usuario y contraseña de Linux.
Paso 2: Instalar Node.js
Dentro de su terminal de Ubuntu, es recomendable usar nvm (Node Versión Manager) para evitar problemas de permisos:
- Instale nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
- Reinicie la terminal.
- Instale Node: nvm install --lts
Paso 3: Instalar OpenClaw
Con Node.js activo, proceda a instalar el paquete global de OpenClaw:
npm install -g openclaw
(Nota: Si encuentra errores de permisos, asegúrese de estar usando nvm como se indicó en el paso anterior).
Paso 4: Configuración inicial
Ejecute el comando de inicialización para generar los archivos de configuración base: openclaw init
Esto creará una carpeta oculta (generalmente .openclaw) en su directorio de inicio de Linux.
Paso 5: Configura tu espacio de trabajo
Es vital que sus proyectos residan dentro del sistema de archivos de Linux para evitar lentitud.
- Ruta recomendada: /home/tu_usuario/proyectos/openclaw_work
- Evite usar /mnt/c/ (la unidad C de Windows) ya que la velocidad de lectura/escritura cae drásticamente entre sistemas.
Paso 6: Configurar la persistencia
Para asegurar que OpenClaw se mantenga activo tras cerrar la terminal o reiniciar, utilice un gestor de procesos como PM2:
- Instalar: npm install -g pm2
- Iniciar OpenClaw: pm2 start openclaw
- Guardar estado: pm2 save
Paso 7: Acceso a la red (Teléfono a WSL)
Para acceder desde un dispositivo móvil en la misma red local, necesita realizar un "Port Forwarding" desde Windows hacia WSL2:
- Identifique la IP de WSL: hostname -I
En PowerShell (como administrador), use: netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=XXXX connectaddress=IP_DE_WSL connectport=XXXX (Sustituya XXXX por el puerto que use su instancia de OpenClaw).
Las trampas (La verdadera razón por la que estás leyendo esto)
Incluso con una instalación perfecta, existen detalles que pueden detener el proceso:
El Firewall de Windows: Es la causa número uno de fallos en el Paso 7. Debe crear una regla de entrada en el Firewall de Windows para permitir el tráfico en el puerto específico de OpenClaw.
Suspensión de WSL: WSL2 entra en "modo sueño" si no hay una terminal abierta. Usar PM2 ayuda, pero a veces es necesario configurar Windows para que no suspenda el subsistema.
Localhost vs 0.0.0.0: Dentro de la configuración de OpenClaw, asegúrese de que el host esté configurado como 0.0.0.0 y no 127.0.0.1 si planea acceder desde otros dispositivos.
Actualización de Kernel: Si recibe errores de virtualización, ejecute wsl --update en PowerShell; a menudo los paquetes de Windows Update se quedan atrás.
Enlaces recomendados
