Guía de configuración de OpenClaw para Windows: instalar en Windows 10 y 11

Introducción

OpenClaw funciona muy bien en Windows, aunque el proceso de instalación difiere ligeramente del de macOS y Linux. Esta guía cubre todo lo que necesita para instalar y ejecutar OpenClaw en Windows 10 o Windows 11, incluida la configuración de PowerShell, la instalación de Node.js y las recomendaciones de WSL2.

Para obtener instrucciones generales de instalación, consulte nuestra guía de instalación completa.

Requisitos del sistema

Versión de Windows

• Windows 10 (versión 1903 o posterior)
• Windows 11 (todas las versiones)
• Las versiones anteriores pueden funcionar pero no son oficialmente compatibles.

Hardware

• RAM: se recomiendan más de 2 GB (más de 4 GB para obtener el mejor rendimiento)
• Almacenamiento: más de 500 MB para instalación, espacio adicional para memoria/datos
• Procesador: cualquier procesador x64 moderno

Requisitos previos del software

• Node.js 18+: necesario para ejecutar OpenClaw
• PowerShell 5.1+ o Windows Terminal: recomendado sobre CMD
• Git (opcional): para instalación pirateable desde el código fuente

Métodos de instalación

Método 1: instalación de npm (recomendado)

La forma estándar de instalar OpenClaw en Windows:

1. Instale Node.js (si aún no está instalado):

   • Descargar desde nodejs.org
   • Elija la versión LTS (18.x o superior)
   • Ejecute el instalador con la configuración predeterminada.
   • Verificar instalación:

     node --version
     npm --version

2. Instalar OpenClaw:

   npm i -g openclaw

3. Verificar la instalación:

   openclaw --version

Método 2: PowerShell de una sola línea

Un script de PowerShell automatiza la instalación:

irm https://openclaw.ai/install.ps1 | iex

Nota: Es posible que necesites habilitar la ejecución del script:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Este script:

• Verifique Node.js (solicitud de instalación si falta)
• Instalar OpenClaw globalmente
• Configurar RUTA si es necesario
• Verificar la instalación

Método 3: Instalación de WSL2 (mejor experiencia)

El Subsistema de Windows para Linux 2 (WSL2) proporciona un entorno Linux que a menudo funciona mejor para OpenClaw:

1. Instalar WSL2:

   wsl --install

   Reinicie su computadora cuando se le solicite.

2. Instala Ubuntu (o tu distribución de Linux preferida):

   wsl --install -d Ubuntu

3. Dentro de WSL2, instale OpenClaw:

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

WSL2 proporciona:

• Mejor compatibilidad con herramientas Unix
• Rendimiento nativo de Linux
• Integración más sencilla con servicios basados en Linux
• Acceso a administradores de paquetes de Linux.

Consulte nuestra guía de configuración de Linux para obtener instrucciones específicas de WSL2.

Método 4: Instalación pirateable (desde la fuente)

Para desarrolladores que quieran modificar la fuente:

1. Instalar Git:

   • Descargar desde git-scm.com
   • O instalar a través de Winget:

     winget install Git.Git

2. Clonar y construir:

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   npm install
   npm run build

3. Ejecutar desde la fuente:

   npm run openclaw onboard

Instalación de Node.js en Windows

Opción 1: Instalador oficial

1. Visita nodejs.org
2. Descargue la versión LTS (18.x o superior)
3. Ejecute el instalador
4. Marque “Agregar a RUTA” durante la instalación.
5. Verificar:

   node --version
   npm --version

Opción 2: Winget (Administrador de paquetes de Windows)

winget install OpenJS.NodeJS.LTS

Opción 3: Chocolate

Si tienes Chocolatey instalado:

choco install nodejs-lts

Opción 4: primicia

Si usas Scoop:

scoop install nodejs-lts

PowerShell frente al símbolo del sistema

PowerShell (recomendado)

PowerShell es más potente y moderno:

• Mejores capacidades de secuencias de comandos
• Más consistente con los comandos multiplataforma
• Mejor manejo de errores
• Soporte JSON nativo

Utilice PowerShell para todos los comandos de OpenClaw.

Símbolo del sistema (CMD)

CMD funciona pero tiene limitaciones:

• Sintaxis anterior
• Scripts menos potentes
• Es posible que algunos scripts npm no funcionen correctamente

Si debe utilizar CMD, los comandos son prácticamente los mismos, pero se recomienda PowerShell.### Terminal de Windows

Windows Terminal proporciona la mejor experiencia:

• Múltiples pestañas
• Mejor representación de fuentes
• Apariencia personalizable
• PowerShell, CMD y WSL integrados

Instalar desde Microsoft Store o:

winget install Microsoft.WindowsTerminal

Configuración posterior a la instalación

Después de la instalación, configure OpenClaw:

openclaw onboard

Esta configuración interactiva cubre:

1. Configuración del modelo de IA

Elija su proveedor de IA:

Claude Anthropic:

• Soneto de Claude 3.5 (recomendado)
• Claude 3 Opus
• Claudio 4

Obtenga su clave API de console.anthropic.com.

OpenAI GPT:

• GPT-4o
• GPT-4 Turbo
• GPT-4.1

Obtenga su clave API de platform.openai.com.

Modelos locales:

• Ollama (se ejecuta localmente)
• Estudio LM
• MiniMax

2. Permisos de Windows

OpenClaw puede solicitar permisos:

• Firewall: permitir Node.js/OpenClaw a través del Firewall de Windows
• Antivirus: es posible que sea necesario incluir el directorio OpenClaw en la lista blanca
• Sistema de archivos — Para leer/escribir archivos

3. Configuración de RUTA

Asegúrese de que OpenClaw esté en su RUTA:

$env:PATH -split ';' | Select-String "npm"

Si no se encuentra, agregue la ruta global de npm:

$npmPath = npm config get prefix
$env:PATH += ";$npmPath"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Reinicie PowerShell después de modificar PATH.

Ejecutando OpenClaw

Iniciar el servidor

openclaw

Esto inicia el servidor local y conecta todas las integraciones configuradas.

Ejecutar en segundo plano

Utilice Start-Process:

Start-Process -NoNewWindow openclaw

O utilice un administrador de procesos como pm2:

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Ejecutar como servicio de Windows

Instale como un servicio de Windows usando node-windows:

npm i -g node-windows

Cree un script de servicio (consulte node-windows docs).

Lanzamiento al inicio

Crea una tarea programada:

1. Abra el Programador de tareas
2. Crear tarea básica
3. Nombre: “OpenClaw”
4. Activador: “Cuando inicio sesión”
5. Acción: “Iniciar un programa”
6. Programa: C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd
7. Argumentos: (dejar en blanco)

O use la carpeta Inicio:

$startup = [Environment]::GetFolderPath("Startup")
$shortcut = "$startup\OpenClaw.lnk"
$shell = New-Object -ComObject WScript.Shell
$link = $shell.CreateShortcut($shortcut)
$link.TargetPath = "C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd"
$link.Save()

Consideraciones específicas de Windows

Software antivirus

Algunos programas antivirus pueden marcar OpenClaw:

• Windows Defender: normalmente funciona bien, puede que necesite exclusión
• AV de terceros: puede requerir inclusión en la lista blanca

Agregar exclusión para:

• Directorio de instalación de OpenClaw
• ~/.openclaw directorio de datos
• Ejecutable Node.js

Configuración del cortafuegos

Permitir OpenClaw a través del Firewall de Windows:

New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -Program "C:\Users\YourName\AppData\Roaming\npm\node_modules\openclaw\bin\openclaw.js" -Action Allow

O utilice la GUI del Firewall de Windows Defender:

1. Seguridad de Windows → Firewall y protección de red
2. Permitir que una aplicación pase por el firewall
3. Agregue OpenClaw

Soporte de largo recorrido

Windows tiene un límite de ruta de 260 caracteres. Habilitar rutas largas:

1. Abra el Editor de políticas de grupo (gpedit.msc)
2. Navegue a: Configuración de la computadora → Plantillas administrativas → Sistema → Sistema de archivos
3. Habilite “Habilitar rutas largas de Win32”
4. Reinicie la computadora

O editar el registro (solo usuarios avanzados).

Finales de línea

Windows usa CRLF, Unix usa LF. La mayoría de las herramientas manejan esto automáticamente, pero si tienes problemas:

git config --global core.autocrlf true

Solución de problemas

Comando no encontrado

Si no se reconoce openclaw:

1. Verifique la ruta global de npm:

   npm config get prefix

2. Agregar a RUTA:

   $npmPath = npm config get prefix
   [Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", [EnvironmentVariableTarget]::User)

3. Reinicie PowerShell

4. Verificar:

   Get-Command openclaw

Permiso denegado

Si ve errores de permiso:

1. Ejecute PowerShell como administrador: Haga clic derecho en PowerShell → “Ejecutar como administrador”

2. Instalar globalmente:

   npm i -g openclaw

3. Reparar permisos de npm (alternativa):

   mkdir $env:APPDATA\npm-global
   npm config set prefix "$env:APPDATA\npm-global"
   $env:PATH += ";$env:APPDATA\npm-global"
   [Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Puerto ya en uso

Cambiar el puerto:

openclaw --port 3001

O busque y elimine el proceso:

netstat -ano | findstr :3000
taskkill /PID <PID> /F

Problemas con la versión de Node.js

Asegúrate de tener Node.js 18+:

node --version

Si está desactualizado, actualice:

winget upgrade OpenJS.NodeJS.LTS
```O descargue la última versión de [nodejs.org](https://nodejs.org/).

### Integración WSL2

Si usa WSL2, acceda a los archivos de Windows:

```bash
# In WSL2
cd /mnt/c/Users/YourName

Acceda a archivos WSL2 desde Windows:

# In PowerShell
cd \\wsl$\Ubuntu\home\username

Consejos de rendimiento

Rendimiento de WSL2

Si usa WSL2:

• Almacenar datos de OpenClaw en el sistema de archivos WSL2 (más rápido)
• Utilice WSL2 para todas las operaciones.
• Acceda a archivos de Windows a través de /mnt/c/ cuando sea necesario

Defensor de Windows

Excluir directorios OpenClaw del escaneo en tiempo real:

1. Seguridad de Windows → Protección contra virus y amenazas
2. Administrar configuración → Exclusiones
3. Agregar carpetas:
   • C:\Users\YourName\AppData\Roaming\npm
   • C:\Users\YourName\.openclaw

Gestión de memoria

Supervisar el uso de recursos:

Get-Process | Where-Object {$_.ProcessName -like "*node*"} | Select-Object ProcessName, CPU, WorkingSet

Actualizando OpenClaw

Actualizar a la última versión:

npm update -g openclaw

O vuelva a ejecutar el instalador:

irm https://openclaw.ai/install.ps1 | iex

Desinstalar

Quitar OpenClaw:

npm uninstall -g openclaw

Eliminar configuración:

Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

Eliminar de PATH (si se agrega manualmente).

Próximos pasos

Ahora que OpenClaw está instalado en Windows:

1. Conectar aplicaciones de chat: WhatsApp, Telegram, Discord
2. Configurar integraciones: Gmail, Slack
3. Explorar habilidades — Biblioteca de habilidades
4. Lea las preguntas frecuentes — Preguntas comunes

Conclusión

Instalar OpenClaw en Windows es sencillo con npm. Si bien WSL2 brinda la mejor experiencia, la instalación nativa de Windows funciona perfectamente para la mayoría de los usuarios. Se recomienda PowerShell sobre CMD para una mejor compatibilidad y capacidades de secuencias de comandos.

Para obtener más ayuda, consulte nuestra guía de instalación general o página de preguntas frecuentes. ¡Feliz automatización en Windows!