Configuración de OpenClaw en Windows

Configurar herramientas de desarrollo en Windows a veces se siente como una pelea constante contra el sistema operativo. Quieres ejecutar un script y terminas depurando variables de entorno o problemas de compatibilidad de la terminal en lugar de trabajar en tu proyecto.

OpenClaw en Windows es sencillo de instalar, pero existen algunos detalles específicos del sistema que debes conocer para evitar errores comunes. He probado el método nativo de PowerShell y el enfoque con WSL2; aquí te explico cómo configurar ambos.

Mi recomendación: WSL2 es el único camino estable oficial. PowerShell funciona para pruebas rápidas, pero tiene limitaciones.

Lo que vas a necesitar

Antes de empezar, asegúrate de cumplir con estos requisitos:

• Windows 10 (versión 1903+) o Windows 11
• PowerShell 5.1 o posterior (ya viene instalado en versiones modernas)
• Una API key de Anthropic, OpenAI o Google (o usar Ollama para modelos locales)
• Node.js (el instalador lo gestionará por ti si no lo tienes)

---

Método 1: PowerShell (Rápido pero limitado)

⚠️ Nota: La instalación nativa en PowerShell no ha sido probada por el equipo oficial y puede presentar problemas de compatibilidad con herramientas. Para entornos de producción, usa WSL2.

Abre PowerShell como Administrador y ejecuta:

iwr -useb https://openclaw.ai/install.ps1 | iex

Qué hace este script

1. Verifica Node.js 22+ (lo instala vía winget, Chocolatey o Scoop si falta).
2. Ejecuta npm install -g openclaw@latest.
3. Inicia el asistente de configuración.

Elige tu método de instalación

El instalador de PowerShell admite dos variantes:

# Por defecto: npm install (recomendado)
iwr -useb https://openclaw.ai/install.ps1 | iex

# Alternativa: Instalar desde el código fuente de GitHub
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git

# Con un directorio personalizado para la instalación de git
iwr -useb https://openclaw.ai/install.ps1 | iex -InstallMethod git -GitDir "C:\openclaw"

---

Método 2: WSL2 (Recomendado)

Si planeas usar OpenClaw de forma intensiva o quieres la experiencia más estable, WSL2 es la mejor opción. Te permite tener un entorno Linux completo dentro de Windows.

Paso 1: Instalar WSL2

Abre PowerShell como Administrador:

wsl --install

Reinicia tu computadora cuando el sistema lo solicite.

Paso 1.5: Activar systemd (Obligatorio)

Después del reinicio, abre Ubuntu y ejecuta:

# Activar systemd para el OpenClaw gateway
sudo nano /etc/wsl.conf

Añade estas líneas:

[boot]
systemd=true

Guarda los cambios (Ctrl+O, Enter, Ctrl+X) y reinicia WSL:

# En PowerShell
wsl --shutdown
wsl

Paso 2: Configurar Ubuntu

Al reiniciar, Ubuntu se abrirá automáticamente. Crea tu usuario y contraseña.

Paso 3: Instalar OpenClaw en WSL

Dentro de tu terminal de Ubuntu:

curl -fsSL https://openclaw.ai/install.sh | bash

Con esto, ya tienes OpenClaw corriendo en un entorno Linux real.

---

Después de la instalación: Asistente de configuración

Una vez instalado, el asistente se iniciará automáticamente para configurar lo siguiente:

1. Proveedor de modelo de AI

Proveedor	Notas
Anthropic (Claude)	El mejor rendimiento, requiere API key
OpenAI	Excelente para programar
Google Gemini	Nivel gratuito disponible
Ollama	100% gratis, corre localmente

2. Canal de chat

Elige cómo hablarás con OpenClaw: WhatsApp, Telegram, Discord o iMessage.

3. Gateway Daemon

Cuando el asistente te pregunte, elige instalar el gateway como un daemon:

openclaw onboard --install-daemon

Esto permite que OpenClaw siga funcionando en segundo plano.

---

Verificar la instalación

# Revisar la versión
openclaw --version

# Ejecutar diagnósticos
openclaw doctor

# Abrir el dashboard
openclaw dashboard

---

Troubleshooting: Problemas comunes en Windows

”openclaw is not recognized”

La carpeta global de binarios de npm no está en tu PATH.

Solución:

# Encuentra tu prefijo de npm
npm config get prefix

# Añade el resultado + \bin a tu PATH
# Normalmente es: %AppData%\npm

Después, reinicia PowerShell.

Error “spawn git ENOENT”

Necesitas Git for Windows para instalaciones desde el código fuente.

Solución:

1. Descarga Git desde git-scm.com/download/win.
2. Instala con los ajustes predeterminados.
3. Reinicia PowerShell e intenta de nuevo.

Problemas con la versión de Node.js

Si tienes una versión antigua de Node.js, actualízala:

# Usando winget
winget install OpenJS.NodeJS.LTS

# Usando Chocolatey
choco install nodejs-lts

# Usando Scoop
scoop install nodejs-lts

Windows Defender bloquea la instalación

Añade una exclusión para el directorio de OpenClaw:

1. Ve a Seguridad de Windows → Protección contra virus y amenazas.
2. Haz clic en “Administrar la configuración”.
3. Busca “Exclusiones” → Agregar o quitar exclusiones.
4. Agrega la carpeta: %AppData%\npm\node_modules\openclaw.

¿Sigues con problemas? Nuestro AI Setup Assistant conoce toda la documentación de OpenClaw y puede ayudarte a solucionar errores específicos de Windows en tiempo real.

---

PowerShell vs WSL2: ¿Cuál elegir?

Aspecto	PowerShell	WSL2
Tiempo de configuración	2 minutos	10 minutos
Estabilidad	Buena	Excelente
Herramientas de terminal	Limitadas	Linux completo
Actualizaciones	Simples	Simples

Mi recomendación: Empieza con PowerShell. Si encuentras errores o necesitas más control, cámbiate a WSL2.

---

Próximos pasos

• Guía general de instalación → — Todas las plataformas.
• Conectar Telegram → — Controla todo desde tu teléfono.
• Despliegue con Docker → — Configuración aislada en contenedores.
• Usar AI local → — Sin costes de API.