Cómo instalar OpenClaw en Windows

OpenClaw es una herramienta potente para crear flujos de trabajo de IA, pero configurarla en Windows puede resultar confuso para principiantes. Esta guía te muestra los principales métodos de instalación para que puedas empezar rápido.

Instalación de OpenClaw en Windows: comparación de 3 métodos

Antes de entrar en los pasos, aquí tienes un resumen rápido de las tres formas de instalar OpenClaw en Windows. Cada método implica distintos equilibrios en tiempo de configuración, cobertura de funciones y requisitos técnicos.

Kimi Claw es una herramienta en línea que te permite ejecutar OpenClaw en el navegador. Se encarga automáticamente de la instalación y la configuración, por lo que no necesitas Node.js, WSL ni configurar una clave de API. Puedes empezar a usar un agent listo para trabajar en cuestión de minutos.

Para una configuración local con PowerShell o WSL2, ve a Método 1 o Método 2. Para omitir por completo la instalación local, salta a Método 3: Kimi Claw. Si quieres empezar más rápido, puedes hacerlo de inmediato.

Qué necesitas antes de instalar OpenClaw localmente en Windows

Si planeas instalar OpenClaw localmente, asegúrate de que tu sistema cumpla con los siguientes requisitos. Si eliges una opción en la nube como Kimi Claw, puedes omitir esta sección por completo.

Requisitos del sistema

• Windows 10 o Windows 11 (64 bits)

• Al menos 4 GB de RAM (se recomiendan 8 GB para compilaciones npm estables)

• Conexión a internet estable

• Privilegios de administrador para la configuración inicial si eliges WSL2

• Para OpenClaw WSL2: la virtualización debe estar habilitada en BIOS/UEFI

Software requerido

• Node.js 22.14 o superior. OpenClaw requiere un runtime moderno de Node.js. Descárgalo desde nodejs.org o instálalo mediante el script de incorporación.

• Git for Windows (opcional, pero recomendado). Algunos paquetes npm y skills dependen de Git.

Método 1: Instalar OpenClaw en Windows con PowerShell

En comparación con WSL2, el método con PowerShell requiere menos pasos y no necesita un entorno Linux. Un solo comando descarga OpenClaw, verifica tu versión de Node.js e inicia el asistente de incorporación. Este método funciona tanto en Windows 10 como en Windows 11.

Paso 1: Instala y ejecuta tu OpenClaw

Windows restringe de forma predeterminada la ejecución de scripts para proteger tu sistema. Antes de instalar OpenClaw, debes permitir que PowerShell ejecute scripts locales con este comando de "interruptor de seguridad":

Luego, ejecuta el siguiente comando:

Después de ejecutar el comando, deberías ver una salida similar a la captura de pantalla de abajo. Cierra y vuelve a abrir PowerShell para actualizar el PATH del sistema antes de continuar con la incorporación.

Paso 2: Confirma el aviso de riesgo y elige el modo de incorporación

Selecciona Yes para aceptar el riesgo y continuar.

A continuación, selecciona QuickStart para iniciar rápidamente la incorporación. Puedes ajustar la configuración más tarde o elegir Manual para una configuración completa.

Paso 3: Configura y autentica tu modelo de IA

1. Selecciona Moonshot AI como proveedor de modelo/autenticación

1. Autentica y configura tu modelo de IA

Para conectar OpenClaw, activa tu clave de Kimi API mediante la Plataforma abierta de Kimi. Aunque una recarga de USD 5 te da un cupón de bonificación de USD 5, recomendamos USD 20 o más para desbloquear el acceso Tier 2. Esto reduce la latencia y garantiza que tu agent de OpenClaw pueda manejar tareas complejas de varios pasos.

1. Crea una clave de Kimi API

Ve a la sección API Keys y haz clic en Create API Key. Recuerda guardar tu clave de API en un lugar seguro y accesible: solo se muestra una vez, al crearla.

1. Ingresa tu clave de API y selecciona el modelo predeterminado

Cuando el asistente de incorporación te lo pida, pega tu clave de API única en la ventana de PowerShell/Terminal.

Cuando se te pida elegir un modelo predeterminado, selecciona moonshot/kimi-k2.5 (o elige "Keep current" si ya está resaltado). Este modelo ofrece el mejor equilibrio entre velocidad y razonamiento para tareas agentic.

Paso 4: Selecciona el canal

Elige qué app quieres conectar a tu OpenClaw. Si no estás seguro, simplemente omítelo.

Paso 5: Configura el rendimiento

Haz clic en Yes para configurar o en No para omitir este paso.

Paso 6: Habilita Hooks

Elige un método para chatear con tu bot y espera a que empiece a ejecutarse.

Paso 7: Ejecuta tu OpenClaw

Cuando hayas completado todo lo anterior, disfruta tu OpenClaw.

Método 2: Instalar OpenClaw en Windows con WSL2

La configuración de OpenClaw WSL2 ofrece un entorno Linux completo dentro de Windows y es la forma recomendada oficialmente para ejecutar OpenClaw. Este método te da acceso al conjunto completo de funciones, incluida la administración de daemons con systemd, scripting nativo de shell y compilaciones npm más fluidas. Si planeas usar OpenClaw en Windows para flujos de trabajo diarios o desarrollo, OpenClaw WSL es la mejor opción.

Paso 1: Habilita WSL2 para OpenClaw en Windows 11/10

Abre PowerShell como Administrador y ejecuta:

Este comando habilita WSL, descarga Ubuntu y lo instala. Cuando el proceso termine, reinicia tu computadora. Al reiniciar Windows, Ubuntu se abrirá y te pedirá crear un nombre de usuario y una contraseña.

Si ya tienes WSL instalado, verifícalo:

Paso 2: Configura WSL2 para systemd

OpenClaw se ejecuta como servicio en segundo plano mediante systemd. Habilítalo en tu configuración de WSL:

Luego reinicia WSL desde PowerShell:

Vuelve a abrir la terminal de Ubuntu y verifica que systemd esté en ejecución:

La salida debe mostrar systemd. Si muestra init, revisa de nuevo tu archivo /etc/wsl.conf.

Paso 3: Instala Node.js 22.14+

OpenClaw requiere Node.js 22.14 o posterior. Instálalo desde el repositorio de NodeSource:

Verifica la instalación:

Paso 4: Instala OpenClaw mediante npm

Con Node.js listo, instala OpenClaw de forma global:

Como alternativa, usa el script oficial de instalación:

Verifica la instalación:

Paso 5: Completa la configuración de OpenClaw en Windows mediante la incorporación

Ejecuta el asistente de incorporación con la bandera de daemon para configurar OpenClaw como servicio de systemd:

El asistente te guiará para:

• Seleccionar tu proveedor de LLM e ingresar tu clave de API

• Elegir un modelo predeterminado

• Configurar canales de mensajería (opcional)

• Instalar el gateway como servicio en segundo plano

Después de la incorporación, habilita la persistencia del servicio para que OpenClaw se inicie automáticamente cuando arranque WSL:

El gateway es el servicio principal en segundo plano que gestiona todas las operaciones de OpenClaw, incluidas las solicitudes de agent, la mensajería y la ejecución del modelo. Confirmar que está en ejecución indica que tu instalación de OpenClaw está completa y lista para usarse, y evita errores en los pasos siguientes.

Ejecuta el siguiente comando en tu terminal de PowerShell o WSL para comprobar su estado:

Método 3: Ejecutar OpenClaw en Windows con Kimi Claw (sin configuración requerida)

Si administrar Node.js, WSL y claves de API te parece más configuración de la que necesitas, Kimi Claw ofrece una forma más sencilla de ejecutar OpenClaw. Te permite ejecutar OpenClaw directamente en el navegador, sin configuración local ni ajustes manuales. Para empezar, sigue estos pasos:

Paso 1: Abre Kimi Claw y crea una instancia

Ve a la página de Kimi Claw y haz clic en Create para comenzar.

Paso 2: Inicia el despliegue

Confirma el despliegue en la ventana emergente. Kimi Claw configura tu entorno de OpenClaw en unos dos minutos, incluidos el gateway, el espacio de trabajo y las herramientas. No se requieren comandos ni configuración manual.

Paso 3: Trabaja en tu espacio de trabajo

Cuando termine el despliegue, tu espacio de trabajo se abrirá en el panel. Desde el navegador puedes empezar a chatear con tu agent de IA, configurar skills, programar tareas y administrar archivos.

Qué obtienes con Kimi Claw

• Cero configuración: no requiere administrar Node.js, WSL ni claves de API

• 40 GB de almacenamiento en la nube: guarda informes, conjuntos de datos y archivos generados que se conservan entre sesiones

• Memoria persistente: tu agent de IA recuerda interacciones anteriores, preferencias y contexto

• Más de 5,000 skills de ClawHub: accede al instante a skills de automatización, investigación, programación y análisis

• Automatización de tareas programadas: configura tareas recurrentes, como informes diarios, recordatorios y monitoreo

• Funciona desde cualquier dispositivo: accede a tu agent de OpenClaw desde cualquier navegador en Windows, Mac o móvil

Firewall de Windows y configuración de seguridad para OpenClaw

Kimi Claw gestiona automáticamente la seguridad y la red en servidores en la nube. Si prefieres instalar OpenClaw localmente con PowerShell o WSL2, conviene configurar algunos ajustes de seguridad recomendados después de la instalación.

• Configurar Windows Firewall

Cuando el gateway de OpenClaw se inicia por primera vez, Windows Firewall puede pedirte que permitas el acceso a la red. Permítelo solo para redes privadas. Si usas OpenClaw WSL2, el gateway se ejecuta dentro del entorno Linux y se comunica a través de localhost, por lo que normalmente no se necesitan reglas adicionales de firewall.

Si Browser Relay u otras funciones no pueden conectarse, asegúrate de que el tráfico de localhost no esté bloqueado por software de seguridad de terceros, como antivirus, clientes VPN o firewalls corporativos.

• Proteger la UI de control

La UI de control de OpenClaw se ejecuta en el puerto 18789 y da acceso completo a tu agent. Nunca expongas este puerto a internet público. Mantén el gateway vinculado a 127.0.0.1 y accede a él únicamente desde tu máquina local.

Para un acceso remoto seguro, usa Tailscale para crear un túnel de red privada:

Esto mantiene el puerto en localhost y, al mismo tiempo, lo hace accesible a través de tu red privada de Tailscale.

Errores comunes al instalar OpenClaw en Windows y cómo solucionarlos

Incluso con una guía clara, pueden surgir problemas durante la instalación. A continuación encontrarás los errores reportados con más frecuencia al instalar OpenClaw en Windows y cómo solucionarlos.

OpenClaw no se reconoce

• Causa: el directorio bin global de npm no está en el PATH del sistema.

• Solución: ejecuta el siguiente comando para encontrar tu prefijo de npm

Agrega la ruta resultante a tus variables de entorno de Windows. No añadas \\bin. Luego cierra y vuelve a abrir PowerShell.

No se encontró Git durante la instalación

• Causa: Git for Windows no está instalado.

• Solución: descarga e instala Git desde git-scm.com. Después de la instalación, reinicia PowerShell y vuelve a intentar con el instalador de OpenClaw para Windows.

La versión de Node.js es demasiado antigua

• Causa: tu sistema tiene una versión anterior de Node.js que no cumple con el requisito mínimo (v22.14+).

• Solución: descarga la versión LTS más reciente desde nodejs.org e instálala. Si usas OpenClaw WSL2, reinstala desde el repositorio de NodeSource.

Errores de permiso denegado

• Causa: PowerShell no tiene permisos suficientes, o no se puede escribir en el directorio global de npm.

• Solución: ejecuta PowerShell como Administrador, o cambia el prefijo global de npm a un directorio donde tu usuario tenga permisos de escritura

El gateway no inicia

• Causa: Port 18789 ya está en uso, o el archivo de configuración está dañado.

• Solución: comprueba si hay procesos en conflicto y reinicia

WSL2 systemd no funciona

• Causa: al archivo /etc/wsl.conf le falta la configuración de systemd.

• Solución: verifica que el archivo contenga la configuración correcta

Si falta la configuración, agrégala y reinicia WSL con wsl --shutdown en PowerShell.

Conclusión

Instalar OpenClaw en Windows puede ir desde una configuración sencilla basada en scripts hasta un entorno WSL2 más avanzado, según tus necesidades. Si quieres control total y flexibilidad, PowerShell y WSL2 son buenas opciones. Si prefieres saltarte la configuración y empezar de inmediato, Kimi Claw te permite ejecutar OpenClaw en tu navegador sin configuración local. Elige el enfoque que mejor se adapte a tu flujo de trabajo y a tu nivel de comodidad técnica, y estarás listo para aprovechar OpenClaw al máximo.