Instalar OpenClaw correctamente es el primer paso para dominar la IA autónoma local. Tras definir qué es OpenClaw, esta guía técnica detalla el proceso de instalación para Windows, macOS, Ubuntu/Linux, Docker y Mac mini con Ollama, con los comandos verificados de 2026 para cada entorno.
< 5 min
Tiempo de Instalación
Node 22+
Entorno Requerido
5 OS
Sistemas Soportados
Requisitos previos: el cimiento técnico
Antes de ejecutar el comando de instalación, verifica estos requisitos. El 70% de los fallos en instalaciones de OpenClaw tienen el mismo origen: una versión de Node.js incorrecta o permisos mal configurados.
Requisito crítico: OpenClaw requiere
Node.js 22 o superior. Verifica tu versión con
node -v. Si tienes Node 20 o inferior, el agente puede congelarse en tareas largas. Recomendamos instalar Node mediante
NVM (Node Version Manager) para evitar conflictos de permisos:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22 && nvm use 22
| Componente |
Mínimo |
Recomendado |
| Node.js |
v22.x LTS |
Última LTS estable |
| RAM |
2GB (solo gateway) |
8GB (con Ollama local) |
| Disco |
500MB |
10GB+ (con modelos locales) |
| Sistema operativo |
Linux, macOS, Windows WSL2 |
Ubuntu 22.04+ / macOS 13+ |
| GPU (opcional) |
No necesaria para APIs externas |
8GB VRAM para Ollama (o Mac M-series) |
Método rápido: script en una línea para macOS y Linux
Si estás en macOS o Linux y quieres el camino más corto, el script oficial instala Node.js (si no lo tienes), OpenClaw y configura el entorno en un solo paso:
curl -fsSL https://openclaw.ai/install.sh | bash
Tras la instalación, verifica que todo está correcto:
openclaw --version # Muestra la versión instalada (ej. v2026.3.11)
openclaw status # Verifica que el daemon está activo
Si el script no es tu opción, más abajo tienes la instalación detallada por sistema operativo.
1. Instalación en Windows 11: el camino de WSL2
OpenClaw no tiene soporte nativo para Windows. El método oficial y recomendado es WSL2 (Windows Subsystem for Linux) con Ubuntu 24.04. Esto garantiza compatibilidad total con las dependencias de Node.js y evita los errores más frecuentes de instalación nativa en Windows.
Instalar OpenClaw en Windows con WSL2
Paso 1: Activar WSL2
Abre PowerShell como administrador (clic derecho → Ejecutar como administrador) y ejecuta:
wsl --install
Reinicia el PC cuando se solicite. Se abrirá Ubuntu automáticamente: configura tu nombre de usuario y contraseña.
Paso 2: Instalar NVM y Node.js 22
Dentro de la terminal de Ubuntu (WSL2), ejecuta:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22 && nvm use 22
node -v # Debe mostrar v22.x.x
Paso 3: Instalar OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
Alternativa: instalación directa desde PowerShell
Si prefieres no usar WSL2, desde PowerShell como administrador:
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
openclaw onboard
Nota: el rendimiento en PowerShell nativo es inferior al de WSL2. Para producción, siempre WSL2.
Sobre el acceso a archivos en WSL2: Para mejor rendimiento, trabaja siempre con archivos dentro del sistema de archivos de Linux (~/proyectos/) y no desde rutas montadas de Windows (/mnt/c/). La diferencia de velocidad es significativa.
2. Instalación en macOS: optimización Apple Silicon
En Mac (chips M1, M2, M3 o M4), OpenClaw se instala de forma nativa y aprovecha la arquitectura de memoria unificada para ejecutar modelos locales con Ollama sin GPU dedicada. Es el entorno más fluido para experimentación y desarrollo.
Instalar OpenClaw en Mac paso a paso
Paso 1: Herramientas de desarrollo de Apple
Abre la Terminal (Cmd + Espacio → busca «Terminal») y ejecuta:
xcode-select --install
Acepta la instalación cuando se solicite. Puede tardar unos minutos.
Paso 2: Instalar NVM y Node.js 22
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.zshrc # o ~/.bash_profile según tu shell
nvm install 22 && nvm use 22
Paso 3: Instalar OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
openclaw onboard # Asistente de configuración inicial
Mac mini como servidor dedicado de OpenClaw
El Mac mini M2 o M4 se ha convertido en la opción preferida de la comunidad para ejecutar OpenClaw localmente como servidor dedicado. Sus ventajas frente a un PC o VPS en este caso de uso concreto son:
- Memoria unificada: Un Mac mini M4 con 32GB puede ejecutar modelos locales de hasta 70B parámetros vía Ollama sin GPU dedicada, algo imposible con RAM convencional del mismo precio.
- Consumo eléctrico: Entre 6W y 20W en uso normal. Un PC equivalente consume 5-10 veces más, lo que hace la diferencia en un servidor que corre 24/7.
- Silencio y tamaño: Sin ventilador audible en uso normal. Se puede colocar en cualquier lugar.
- Activación por voz: La integración con el ecosistema Apple permite activar el agente con «Hey Claw» desde el iPhone.
Configuración recomendada para Mac mini dedicado: Desactiva el modo de reposo en Preferencias del Sistema → Batería → impide que el Mac se duerma automáticamente. Si necesitas acceso remoto desde fuera de casa, usa un túnel Cloudflare en lugar de abrir puertos en el router.
Para análisis completo de precios y configuraciones del Mac mini M4 para IA local, consulta nuestra guía de infraestructura de IA local.
3. Instalación en Ubuntu y Linux: máxima estabilidad
Linux es el entorno natural de OpenClaw para producción. Ubuntu 22.04 LTS y Ubuntu 24.04 LTS son las distribuciones con mayor compatibilidad documentada. La instalación en Debian, CentOS y Arch también es posible con ajustes menores.
Instalar OpenClaw en Ubuntu 22.04 / 24.04
Paso 1: Actualizar el sistema e instalar NVM
sudo apt update && sudo apt install -y curl git
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
Paso 2: Instalar Node.js 22 y verificar
nvm install 22 && nvm use 22
node -v # Debe mostrar v22.x.x
npm -v # Debe mostrar 10.x o superior
Paso 3: Instalar OpenClaw con el script oficial
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
openclaw status
Paso 4: Ajuste de permisos y seguridad
# Proteger el archivo .env con permisos restrictivos
chmod 600 ~/.openclaw/.env
# Nunca ejecutes OpenClaw como root
# Crea un usuario dedicado si lo usas en servidor
adduser openclaw-user
su - openclaw-user
Alternativa: instalación via npm
Si prefieres la instalación via npm en lugar del script:
npm install -g openclaw
openclaw --version
Ejecutar OpenClaw como servicio en Linux
Para producción, configura OpenClaw como servicio systemd para que se reinicie automáticamente tras caídas o reinicios del servidor:
# Crear archivo de servicio
sudo nano /etc/systemd/system/openclaw.service
# Contenido del archivo:
[Unit]
Description=OpenClaw AI Agent Gateway
After=network.target
[Service]
Type=simple
User=openclaw-user
ExecStart=/home/openclaw-user/.nvm/versions/node/v22.x.x/bin/openclaw start
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target
# Activar e iniciar el servicio
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw
4. Instalación con Docker: el método más seguro para producción
Docker es el método recomendado para entornos de producción en cualquier sistema operativo. El contenedor aísla completamente OpenClaw del sistema host, resuelve todos los problemas de dependencias y permite actualizaciones con un solo comando.
Instalar OpenClaw con Docker
Opción A: Instalación rápida con imagen oficial
docker pull openclaw/openclaw:latest
docker run -d \
--name openclaw \
-p 18789:18789 \
-v ~/.openclaw:/root/.openclaw \
--env-file ~/.openclaw/.env \
--restart unless-stopped \
openclaw/openclaw:latest
El dashboard queda disponible en
http://127.0.0.1:18789
Opción B: Docker Compose (recomendado para persistencia)
version: '3.8'
services:
openclaw:
image: openclaw/openclaw:latest
ports:
- "18789:18789"
volumes:
- ~/.openclaw:/root/.openclaw
env_file:
- ~/.openclaw/.env
restart: unless-stopped
Guarda como
docker-compose.yml y ejecuta
docker compose up -d
Conectar canales tras la instalación Docker
# WhatsApp (escanear QR)
docker compose run --rm openclaw-cli channels login
# Telegram
docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>"
# Ver logs en tiempo real
docker compose logs -f
Actualizar OpenClaw en Docker
docker pull openclaw/openclaw:latest
docker compose up -d # Reinicia con la nueva imagen
5. OpenClaw con Ollama: modelos locales sin coste de API
La combinación OpenClaw + Ollama permite ejecutar el agente completo sin enviar datos a ningún proveedor externo y sin coste de API. Es la opción de máxima privacidad y la favorita para usuarios con Mac M-series o hardware con GPU.
Instalar OpenClaw con Ollama paso a paso
Paso 1: Instalar Ollama
# macOS y Linux
curl -fsSL https://ollama.ai/install.sh | sh
# Verificar instalación
ollama --version
Paso 2: Descargar un modelo
# Modelos recomendados según hardware:
ollama pull llama3.2 # 4GB VRAM — para hardware básico
ollama pull deepseek-r1:8b # 8GB VRAM — buena relación calidad/rendimiento
ollama pull qwen2.5:32b # 20GB+ RAM — para Mac M-series con memoria unificada
Paso 3: Integración directa Ollama + OpenClaw
Si Ollama está instalado, el script de OpenClaw lo detecta automáticamente:
curl -fsSL https://openclaw.ai/install.sh | bash
# Selecciona "Ollama" como proveedor durante el onboarding
O configura manualmente en
~/.openclaw/.env:
LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=deepseek-r1:8b
Limitación importante de Ollama: El agente solo funciona mientras el PC o Mac esté encendido. Para disponibilidad 24/7 con modelos locales necesitas un Mac mini o PC dedicado que no se apague. Si no quieres gestionar esa infraestructura,
Hostinger OpenClaw incluye créditos de IA preinstalados con disponibilidad garantizada a 5,99€/mes.
Comparativa de rendimiento por entorno
| Sistema |
Estabilidad |
Latencia local |
Disponibilidad 24/7 |
Facilidad |
| Linux Ubuntu (nativo) |
⭐⭐⭐⭐⭐ Máxima |
< 15ms |
✅ Con systemd |
Media (CLI) |
| Docker |
⭐⭐⭐⭐⭐ Máxima |
~ 18ms |
✅ Con restart policy |
Media |
| macOS M-series |
⭐⭐⭐⭐ Alta |
~ 20ms |
✅ Mac mini dedicado |
Alta |
| Windows (WSL2) |
⭐⭐⭐ Media-Alta |
~ 45ms |
⚠️ Depende del PC |
Baja (configuración) |
| Hostinger (gestionado) |
⭐⭐⭐⭐⭐ Máxima |
~ 20ms |
✅ 99.9% SLA |
Ninguna — 1 clic |
Análisis Crítico: ¿Dónde instalar OpenClaw para producción?
La experiencia técnica acumulada en 2026 dicta una sentencia clara: para entornos de desarrollo rápido y ejecución de modelos locales, macOS con chips M-series no tiene rival gracias a su arquitectura de memoria unificada. Para agentes que deben operar 24/7 de forma autónoma, un servidor Linux con Docker es el estándar de producción.
Veredicto Mac: La estación de trabajo ideal. Los chips M3/M4 mueven modelos de 70B parámetros en local con eficiencia insuperable en vatio/rendimiento. El Mac mini dedicado es la mejor opción para uso doméstico profesional.
Veredicto Linux: El estándar para producción. Docker sobre Ubuntu gestiona el stack de red y procesos sin latencia añadida y con reinicio automático. Si el agente procesa miles de archivos, Linux + Docker es la única elección razonable.
Veredicto Windows: Únicamente bajo WSL2. La instalación nativa sigue sufriendo con la gestión de dependencias complejas. WSL2 funciona bien pero añade ~30ms de latencia extra respecto a Linux nativo.
¿Quieres saltarte toda esta configuración?
La instalación manual puede generar errores de dependencias, conflictos de permisos y horas de depuración. La forma más estable y profesional de tener OpenClaw en 2026 es mediante un VPS con Docker preinstalado y OpenClaw preconfigurado. Fácil, rápido y disponible 24/7 sin preocupaciones técnicas.
Hemos preparado una guía específica para Hostinger, o puedes ir directamente al grano:
Acceder al Plan Docker Starter de Hostinger (-20%)
FAQ de instalación de OpenClaw
1. ¿Puedo instalar OpenClaw en un hosting compartido?
No. OpenClaw requiere acceso root para gestionar el sistema de archivos y procesos en segundo plano. Necesitas un VPS, servidor dedicado, Mac o PC propio. La alternativa más sencilla es el plan gestionado de Hostinger, que incluye OpenClaw preconfigurado sin necesidad de acceso root.
2. ¿Qué hacer si npm install da error de permisos?
Usa NVM en lugar de instalar Node.js con sudo. NVM instala Node en tu directorio de usuario, evitando todos los conflictos de permisos: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash && nvm install 22.
3. ¿Es compatible con modelos locales como DeepSeek?
Sí. Instala Ollama, descarga el modelo con ollama pull deepseek-r1:8b y configura en ~/.openclaw/.env: LLM_PROVIDER=ollama y OLLAMA_BASE_URL=http://localhost:11434.
4. ¿Cuánta RAM necesito?
El framework base ocupa menos de 500MB. Para uso con APIs externas, 4GB son suficientes. Para modelos locales con Ollama, mínimo 8GB de RAM (o VRAM en GPU), y 32GB si quieres modelos de 70B en Mac M-series.
5. ¿OpenClaw soporta Docker?
Sí. La imagen oficial es openclaw/openclaw:latest. El gateway corre en el puerto 18789 y el dashboard queda accesible en http://127.0.0.1:18789. Docker es el método recomendado para producción en Linux.
6. ¿Debo actualizar Node.js si ya tengo la versión 20?
Sí. Las mejoras en la gestión de memoria de Node 22 son críticas para evitar que el agente se congele durante tareas largas. Actualiza con nvm install 22 && nvm use 22.
7. ¿Puedo instalar OpenClaw en Mac mini?
Sí, y es una de las mejores opciones para uso doméstico. Un Mac mini M2 o M4 puede ejecutar OpenClaw con modelos locales de hasta 70B parámetros vía Ollama sin GPU dedicada. Se recomienda dedicarlo exclusivamente al agente para garantizar disponibilidad continua.
8. ¿Cómo actualizo OpenClaw?
Con npm: npm update -g openclaw. Con Docker: docker pull openclaw/openclaw:latest && docker compose up -d. Verifica siempre la versión instalada con openclaw --version. La versión más reciente es v2026.3.11.
Etiquetas: instalar openclaw, instalar openclaw ubuntu, instalar openclaw linux, instalar openclaw windows, instalar openclaw docker, instalar openclaw mac mini, openclaw ollama, openclaw node.js 22, guia instalacion openclaw 2026
