Cómo instalar OpenClaw en tu sistema

Instalar herramientas nuevas no debería ser un dolor de cabeza. A veces pasas más tiempo configurando variables de entorno y resolviendo conflictos de versiones que usando el software.

OpenClaw está diseñado para que evites esas configuraciones manuales tediosas y empieces a trabajar de inmediato. Aquí tienes los pasos para dejarlo listo en pocos minutos.

Requisitos previos

Para que todo funcione correctamente, asegúrate de cumplir con estos requisitos:

• Node 22+ (el script de instalación lo instalará por ti si te falta)
• macOS, Linux o Windows (en Windows te recomendamos usar WSL2)
• pnpm solo si decides compilar desde el código fuente

Inicio rápido

La forma más rápida de empezar es usar el installer script. Este script detecta Node, lo instala si es necesario y lanza el asistente de configuración.

1. Ejecuta el instalador

Elige el comando según tu sistema operativo:

macOS / Linux / WSL2

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

Windows (PowerShell)

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

2. Opciones de instalación

Si prefieres instalar solo el binario sin iniciar el asistente automático, usa estos comandos:

macOS / Linux / WSL2

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

Windows (PowerShell)

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

3. Verifica la instalación

Una vez terminado, comprueba que todo esté en orden con estos comandos:

openclaw doctor         # revisa problemas de configuración
openclaw status         # estado del Gateway
openclaw dashboard      # abre la interfaz en el navegador

Solución de problemas

Si encuentras problemas durante el proceso, aquí tienes las soluciones a los fallos más comunes reportados.

Errores al compilar sharp

Si tienes libvips instalado de forma global y la instalación de sharp falla, fuerza el uso de binarios precompilados:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Comandos no encontrados en pnpm

Si usas pnpm, recuerda que este gestor requiere aprobación explícita para scripts de construcción. Ejecuta esto después de instalar:

pnpm approve-builds -g

El comando openclaw no se reconoce

Si tu terminal no encuentra el comando, es probable que el directorio de binarios de npm no esté en tu PATH.

En macOS / Linux, añade esto a tu archivo .zshrc o .bashrc:

export PATH="$(npm prefix -g)/bin:$PATH"

En Windows, añade el resultado de ejecutar npm prefix -g a tus variables de entorno del sistema.

¿Necesitas ayuda personalizada? Prueba nuestro AI Setup Assistant.

Próximos pasos

• Actualizar OpenClaw
• Migrar a otra máquina
• Desinstalar OpenClaw
• Variables de entorno