Cómo instalar OpenClaw — Guía completa de instalación para Windows, Mac y Linux

Instalar OpenClaw lleva unos 5 minutos. Necesitarás Node.js 22+, Git y 8 GB de RAM. La forma más rápida es un solo comando npm install -g openclaw@latest seguido del asistente de configuración. Alternativamente, omite la instalación por completo con el hosting gestionado de MyClaw.ai.

Lo que necesitas antes de instalar OpenClaw

Antes de instalar OpenClaw en tu máquina, reúne estos requisitos:

RequisitoMínimoRecomendadoRAM8GB16GBAlmacenamiento10GB20GBNode.jsv22v22+ (último LTS)SOWin 10 (WSL2) / macOS 12 / Ubuntu 20.04Última versión estable

Opción 1: Omitir la instalación con hosting gestionado

¿No quieres lidiar con la instalación? MyClaw.ai ofrece hosting completamente gestionado de OpenClaw — tu instancia está lista en segundos sin configuración alguna:

• Configuración instantánea — Sin instalar, sin configurar, sin comandos de terminal
• Siempre funcionando — Disponibilidad 24/7 sin mantener tu ordenador encendido
• Actualizaciones automáticas — Siempre ejecutando la última versión de OpenClaw

Empieza con MyClaw.ai →

---

Opción 2: Alojar OpenClaw tú mismo

Hay dos formas de auto-alojamiento: la instalación global recomendada (la más fácil) o compilar desde el código fuente (para desarrolladores).

Recomendado: Instalación global

Esta es la forma más rápida de poner OpenClaw en funcionamiento en cualquier plataforma:

npm install -g openclaw@latest
openclaw onboard --install-daemon

El asistente de configuración te guía a través de la configuración de tu gateway, espacio de trabajo, canales y skills. La bandera --install-daemon configura un servicio en segundo plano (launchd en macOS, systemd en Linux) para que OpenClaw funcione de forma persistente.

Después de la configuración, verifica tu instalación:

openclaw doctor

---

Alternativa: Compilar desde el código fuente

Si prefieres control total o quieres contribuir a OpenClaw, puedes compilar desde el código fuente. Sigue las guías específicas para cada plataforma a continuación.

Instalar OpenClaw en Windows

Se recomienda encarecidamente WSL2 para ejecutar OpenClaw en Windows. Instala WSL2 primero y luego sigue las instrucciones de Linux a continuación.

Si aún deseas ejecutarlo nativamente en Windows:

Paso 1: Instalar prerequisitos

1. Descarga Node.js v22+ (versión LTS)
2. Descarga Git para Windows
3. Instala pnpm — el gestor de paquetes preferido de OpenClaw
4. Reinicia tu terminal después de la instalación

Verifica las instalaciones:

node --version   # Debería ser v22 o posterior
git --version
pnpm --version

Paso 2: Clonar el repositorio de OpenClaw

Abre PowerShell o Símbolo del sistema y ejecuta:

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Paso 3: Instalar y compilar

pnpm install
pnpm ui:build
pnpm build

Esto descarga todos los paquetes necesarios y compila el proyecto.

Paso 4: Ejecutar el asistente de configuración

pnpm openclaw onboard --install-daemon

El asistente te guía a través de la configuración de OpenClaw, incluyendo la configuración de tu modelo de IA, canales y espacio de trabajo.

Instalar OpenClaw en macOS

Paso 1: Instalar prerequisitos

La forma más fácil es usando Homebrew:

# Instalar Homebrew si es necesario
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Instalar Node.js y Git
brew install node git

# Instalar pnpm
brew install pnpm

Paso 2: Clonar y compilar

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Paso 3: Ejecutar el asistente de configuración

pnpm openclaw onboard --install-daemon

Esto configura un servicio launchd para que OpenClaw se ejecute en segundo plano automáticamente.

Permisos de macOS

OpenClaw puede solicitar permisos de accesibilidad para grabación de pantalla y funciones de voz. Cuando se te solicite, ve a:

Ajustes del Sistema > Privacidad y Seguridad > Accesibilidad

Añade tu aplicación de terminal a la lista de permitidos.

Instalar OpenClaw en Linux (Ubuntu/Debian)

Paso 1: Instalar prerequisitos

# Actualizar gestor de paquetes
sudo apt update

# Instalar Node.js 22 vía NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Instalar Git
sudo apt install -y git

# Instalar pnpm
npm install -g pnpm

Paso 2: Clonar y compilar

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

Paso 3: Ejecutar el asistente de configuración

pnpm openclaw onboard --install-daemon

Esto configura un servicio de usuario systemd para que OpenClaw funcione de forma persistente en segundo plano.

Solución de problemas comunes de instalación

"pnpm install" falla con errores de permisos

En Linux/macOS, evita usar sudo con pnpm o npm. En su lugar, corrige los permisos:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

Error "Versión de Node no compatible"

OpenClaw requiere Node.js 22 o posterior:

node --version

Si tu versión es anterior, descarga la última desde nodejs.org o usa nvm para gestionar versiones:

nvm install 22
nvm use 22

Puerto ya en uso

Otra aplicación está usando el mismo puerto. Puedes:

• Detener la aplicación en conflicto
• Especificar un puerto diferente: openclaw gateway --port 18790

Dependencias nativas faltantes

En Linux, puede que necesites herramientas de compilación adicionales:

sudo apt install build-essential

Ejecutar la herramienta de diagnóstico

OpenClaw incluye un comando de diagnóstico integrado que verifica tu configuración:

openclaw doctor

Verificar tu instalación

Después de instalar OpenClaw, ejecuta la herramienta de diagnóstico para confirmar que todo funciona:

openclaw doctor

Luego prueba con un simple comando de agente:

openclaw agent --message "Hola, ¿estás funcionando?"

Si OpenClaw responde, tu instalación está completa.

Actualizar OpenClaw

Para actualizar tu instalación de OpenClaw a la última versión:

Si se instaló globalmente:

openclaw update --channel stable

Si se compiló desde el código fuente:

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

Próximos pasos

Ahora que OpenClaw está instalado:

• Lee la Guía de inicio para aprender el uso básico
• Aprende más sobre Qué es OpenClaw
• Explora las opciones de hosting de OpenClaw para ejecutarlo 24/7