Instalación

Instalar OpenClaw desde cero es muy sencillo. Sigue los pasos de abajo y en unos 5-10 minutos lo tendrás listo. No te preocupes, te explicamos qué hace cada paso.

📋 Requisitos del sistema

Antes de empezar la instalación, asegúrate de que tu ordenador cumple estos requisitos básicos:

Node.js 22 o superior — Es el entorno base que necesita OpenClaw para funcionar (no te preocupes, el script de instalación lo comprobará por ti)
Sistema operativo — macOS, Linux o Windows (requiere WSL2)
Memoria — Al menos 2 GB de RAM disponible
Espacio en disco — Al menos 500 MB de espacio libre
Red — Se necesita conexión a internet para descargar y llamar a las APIs de los modelos de IA

ℹ️ ¿Qué es Node.js? En pocas palabras, Node.js es como un "traductor" que permite a tu ordenador ejecutar programas escritos en JavaScript. OpenClaw está escrito en JavaScript, así que necesita Node.js para funcionar. No necesitas aprender JavaScript, solo tienes que instalar Node.js.

ℹ️ ¿Qué es WSL2? Los usuarios de Windows deben tener en cuenta que OpenClaw no se ejecuta directamente en Windows, sino que necesita WSL2 (Windows Subsystem for Linux 2), que es como un mini sistema Linux dentro de Windows. Si usas Windows, el script de instalación se encargará de esto automáticamente.

🌟 Método 1: Script de instalación con un solo comando (¡Recomendado para principiantes!)

Esta es la forma más sencilla de instalar. Solo tienes que copiar y pegar un comando en la terminal y el script hará todo automáticamente. ¡Es muy fácil, solo sigue los pasos!

💡 ¿Qué es la "terminal"? La terminal es una ventana donde puedes escribir comandos de texto. En macOS se llama "Terminal", y en Windows se llama "PowerShell" o "Símbolo del sistema". Puedes buscar "Terminal" en tu ordenador para encontrarla.

Abre la Terminal

Pulsa Command + Espacio, escribe "Terminal" y pulsa Enter. Se abrirá una ventana de línea de comandos negra (o blanca).

Copia y pega el comando de instalación

Copia la siguiente línea de comando, pégala en la ventana de la terminal y pulsa Enter:

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

Este comando hará lo siguiente:

Comprobará si tienes Node.js instalado y, si no, lo instalará automáticamente
Descargará e instalará la última versión de OpenClaw
Ejecutará el asistente de configuración inicial (onboarding) para guiarte en la configuración básica

Espera a que termine la instalación

La instalación tarda unos 2-5 minutos, dependiendo de tu velocidad de internet. Verás un montón de texto desplazándose en la terminal, eso es normal, ¡no te preocupes! Cuando termine, entrará automáticamente en el asistente de configuración.

Abre la Terminal

En Linux, puedes pulsar Ctrl + Alt + T para abrir la terminal, o buscar "Terminal" en el menú de aplicaciones.

Copia y pega el comando de instalación

Igual que en macOS, copia el siguiente comando, pégalo en la terminal y pulsa Enter:

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

El script comprobará Node.js automáticamente, descargará e instalará OpenClaw y ejecutará el asistente de configuración.

Espera a que termine la instalación

Ten paciencia durante unos minutos. Cuando veas el asistente de configuración, ¡la instalación ha sido exitosa!

Abre PowerShell (como administrador)

Busca "PowerShell" en el menú de inicio, haz clic derecho y selecciona "Ejecutar como administrador". Este paso es importante porque la instalación necesita permisos de administrador.

Copia y pega el comando de instalación

Los usuarios de Windows usan este comando especial:

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

Este script hará automáticamente lo siguiente:

Comprobar y configurar WSL2 (si no está instalado)
Instalar Node.js
Descargar e instalar OpenClaw
Ejecutar el asistente de configuración inicial

Espera a que termine la instalación

En Windows la instalación puede tardar un poco más (porque puede necesitar instalar WSL2), unos 5-10 minutos. Cuando termine, entrará automáticamente en el asistente de configuración.

⚠️ Nota para usuarios de Windows: Después de instalar WSL2, puede que necesites reiniciar el ordenador. Si el script te pide reiniciar, hazlo primero y luego vuelve a ejecutar el comando de instalación.

📦 Método 2: Instalación mediante npm

Si ya estás familiarizado con Node.js y npm (el gestor de paquetes de Node.js), puedes usar este método. Te da más control sobre la instalación.

Confirma que Node.js está instalado

Abre la terminal y escribe el siguiente comando para comprobar la versión de Node.js:

node --version

Si muestra v22.x.x o superior, ya estás listo. Si no está instalado o la versión es demasiado antigua, ve a nodejs.org para descargar e instalar la última versión.

Instala OpenClaw globalmente con npm

Ejecuta en la terminal:

npm install -g openclaw@latest

Explicación del comando:

npm install — Usa npm para instalar software
-g — Instalación global, para poder usar el comando openclaw desde cualquier lugar
openclaw@latest — Instala la última versión de OpenClaw

Ejecuta la configuración inicial y registra el servicio en segundo plano

Una vez instalado, ejecuta:

openclaw onboard --install-daemon

Este comando hace dos cosas:

onboard — Inicia el asistente de configuración que te guiará por la configuración inicial (elegir modelo de IA, introducir clave API, etc.)
--install-daemon — Registra OpenClaw como servicio en segundo plano (daemon), para que se inicie automáticamente al encender el ordenador sin necesidad de abrirlo manualmente cada vez

💡 ¿Qué es un daemon (proceso en segundo plano)? En pocas palabras, es un programa que se ejecuta silenciosamente en segundo plano. No ves su ventana, pero sigue funcionando. Con --install-daemon, OpenClaw se ejecutará en segundo plano de forma silenciosa, siempre listo para recibir tus mensajes.

🐳 Método 3: Instalación con Docker

Si te gusta usar Docker (una tecnología de contenedores), o quieres que OpenClaw se ejecute en un entorno completamente aislado, puedes elegir este método.

ℹ️ ¿Qué es Docker? Docker es como una "caja virtual" donde puedes ejecutar software. Así, incluso si el software tiene problemas, no afectará a tu ordenador. Si no sabes qué es Docker, te recomendamos usar el Método 1 o el Método 2 para la instalación.

Asegúrate de que Docker esté instalado

Si aún no tienes Docker instalado, ve a docker.com para descargar e instalar Docker Desktop.

Ejecuta el contenedor Docker de OpenClaw

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

Este comando descargará la imagen Docker de OpenClaw e iniciará el contenedor. El parámetro -v mapea los archivos de configuración a tu ordenador, para que no se pierdan los datos.

✅ Verificación después de la instalación

Una vez completada la instalación, vamos a confirmar que todo funciona correctamente. Sigue estos pasos:

Ejecuta el chequeo de salud

openclaw doctor

Este comando es como hacerle un "chequeo médico" a OpenClaw. Comprobará que todos los componentes necesarios funcionan correctamente. Si todo está bien, verás un montón de marcas verdes.

Comprueba el estado

openclaw status

Este comando te dice si OpenClaw está en funcionamiento. Si muestra "running", ¡todo está perfecto!

Abre el panel de control web

openclaw dashboard

Este comando abrirá automáticamente el navegador para acceder al panel de control web de OpenClaw. La dirección es:

http://127.0.0.1:18789/

En este panel podrás ver todos los ajustes y el estado de OpenClaw de forma muy intuitiva.

🎉 Si los tres comandos se ejecutaron sin errores, ¡enhorabuena! OpenClaw se ha instalado correctamente. Ahora ve a la sección de Inicio rápido para aprender cómo empezar a usarlo.

🛠️ Problemas comunes de instalación

Si encuentras algún problema, ¡no te asustes! Aquí tienes los problemas más comunes durante la instalación y cómo resolverlos:

Problema 1: Comando no encontrado (command not found: openclaw)

Esto suele ser un problema con la variable de entorno PATH. En pocas palabras, tu ordenador no sabe dónde está el comando openclaw.

Solución:

# Ver dónde está instalado openclaw
which openclaw || npm list -g openclaw

# Si usas bash, añade la ruta al archivo de configuración
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Si usas zsh (predeterminado en macOS)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Problema 2: Versión de Node.js demasiado antigua

Si ves un error como "Node.js v18 is not supported", necesitas actualizar Node.js.

Solución:

# Usa nvm (Node Version Manager) para gestionar versiones de Node.js
# Primero instala nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Instala Node.js 22
nvm install 22

# Cambia a Node.js 22
nvm use 22

# Confirma la versión
node --version

Problema 3: Conflicto de puertos (EADDRINUSE)

Si ves "EADDRINUSE: address already in use :::18789", significa que el puerto 18789 ya está siendo usado por otro programa.

Solución:

# Buscar el proceso que ocupa el puerto 18789
lsof -i :18789

# Si es un proceso antiguo de OpenClaw, detenlo primero
openclaw stop

# Luego reinícialo
openclaw start

Problema 4: Permisos insuficientes (EACCES)

Puede ocurrir al instalar globalmente con npm en Linux/macOS.

Solución:

# Método A: Cambiar el directorio de instalación global de npm
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Luego reinstala
npm install -g openclaw@latest

⚠️ ¡Nunca uses sudo npm install -g! Aunque usar sudo puede resolver el problema de permisos, puede causar otros problemas de seguridad. Usa el método de arriba para cambiar el directorio de instalación global de npm.

Problema 5: Tiempo de espera de red agotado

Si la descarga es muy lenta o se agota el tiempo, puede ser un problema de red.

Solución:

# Configurar npm para usar un registro espejo (recomendado si tienes problemas de red)
npm config set registry https://registry.npmmirror.com

# Luego reinstala
npm install -g openclaw@latest