¿Cuáles son los requisitos mínimos de servidor para OpenClaw?

Necesita al menos 2 núcleos vCPU, 4 GB de RAM y 20 GB de almacenamiento SSD. Ubuntu 22.04+, Debian 12+ o cualquier distribución Linux con soporte Docker funciona. macOS y Windows (vía WSL2) son válidos para desarrollo local, pero no se recomiendan para producción.

¿Qué método de instalación es mejor para principiantes?

El instalador one-liner (curl -fsSL https://openclaw.sh | bash) es la opción más rápida y sencilla. Detecta automáticamente su SO, instala las dependencias y le guía en la configuración. El proceso completo tarda unos 5 minutos en un VPS nuevo.

¿Puedo ejecutar OpenClaw con Docker?

Sí. OpenClaw publica una imagen Docker oficial. Use la plantilla docker-compose.yml del Método 3 de arriba. Docker es ideal para entornos aislados, rollbacks sencillos y despliegues consistentes. Monte siempre el directorio data/ como volumen para no perder la memoria ni el historial de conversaciones.

¿Necesito un nombre de dominio para ejecutar OpenClaw?

No. OpenClaw funciona por defecto con la dirección IP de su servidor. Sin embargo, se recomienda un nombre de dominio si quiere certificados SSL vía Let's Encrypt y URLs de webhook más limpias para canales de mensajería como WhatsApp y Telegram.

¿Cómo actualizo OpenClaw tras la instalación?

Para instalaciones con one-liner y npm, ejecute openclaw update. Para Docker, ejecute docker compose pull && docker compose up -d. Para instalaciones desde el código fuente, ejecute git pull && pnpm install && pnpm build. Haga siempre una copia de seguridad de su archivo .env y del directorio data/ antes de actualizar.

Cómo instalar OpenClaw en 2026, paso a paso | VPS, Docker, Mac

¿Prefiere que los expertos se encarguen?

Olvídese del terminal. Nuestro equipo instala, protege y configura OpenClaw por usted. Planes desde 299 $.

Ver planes

Requisitos previos

Antes de instalar OpenClaw, asegúrese de que su servidor cumple con estos requisitos mínimos. Quedarse por debajo de estas especificaciones provoca respuestas lentas, procesos caídos y usuarios frustrados.

CPU

2 núcleos vCPU como mínimo. 4 vCPU recomendados para configuraciones multicanal.

RAM

4 GB mínimo. 8 GB recomendados si ejecuta LLMs locales mediante Ollama.

Almacenamiento

20 GB SSD como mínimo. Las bases de datos de memoria y los logs crecen con el tiempo. Planifique 50 GB a largo plazo.

Ubuntu 22.04+, Debian 12+ o cualquier Linux compatible con Docker. macOS y Windows (WSL2) también funcionan.

También necesitará

Acceso SSH a su servidor. Si puede ejecutar ssh root@su-servidor-ip, está listo.
Una clave API de un modelo de IA de Anthropic, OpenAI, Google o un modelo local mediante Ollama. Consígala antes de empezar.
Un nombre de dominio (opcional). No es obligatorio, pero se recomienda para SSL y URLs de webhook limpias.

¿Necesita un VPS? Recomendamos Hetzner (CX22 a ~4,50 $/mes) o DigitalOcean (Basic Droplet a 6 $/mes). Ambos superan los requisitos mínimos.

1.One-Liner (Recomendado)

La forma más rápida de instalar OpenClaw. Un único comando se encarga de todo: verificación de dependencias, descargas, asistente de configuración y creación del servicio. Funciona en Ubuntu, Debian, CentOS, Fedora, Arch y macOS.

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

Lo que hace el instalador

Detecta su sistema operativo y gestor de paquetes

Instala Node.js 20 LTS si no está presente

Instala pnpm globalmente para una resolución de dependencias más rápida

Descarga la última versión estable de OpenClaw

Ejecuta el asistente de configuración interactivo

Crea un servicio systemd (Linux) o un agente launchd (macOS)

Arranca OpenClaw y confirma que está funcionando

Salida esperada

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard

El instalador nunca se ejecuta con más privilegios de los necesarios. Revise el código fuente del script antes de ejecutarlo. Lo recomendamos para todos los scripts canalizados por pipe.

Flags personalizados

Pase flags para personalizar la instalación sin el asistente interactivo.

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

2.npm / pnpm

Ideal para desarrolladores que quieren control total sobre el proceso. Este método ofrece visibilidad explícita de cada paso.

Paso 1 — Instalar Node.js 20+

OpenClaw requiere Node.js 20 o superior. Compruebe primero su versión.

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

Paso 2 — Instalar pnpm

npm install -g pnpm

Paso 3 — Instalar OpenClaw globalmente

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

Paso 4 — Inicializar la configuración

El comando init crea un archivo .env y un directorio data/ en su carpeta actual.

mkdir ~/openclaw && cd ~/openclaw
openclaw init

Paso 5 — Editar su archivo .env

.envenv

# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

Paso 6 — Arrancar OpenClaw

openclaw start
# Or run in background:
openclaw start --daemon

Use openclaw logs para ver la salida en tiempo real. Añada --follow para transmitir las nuevas entradas.

3.Docker

Docker aísla OpenClaw de su sistema host. Las actualizaciones son simples: descargue la nueva imagen y reinicie. Este método es ideal para servidores de producción y equipos.

Paso 1 — Instalar Docker

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

Paso 2 — Crear docker-compose.yml

docker-compose.ymlyaml

version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Paso 3 — Crear su archivo .env

.envenv

OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

Paso 4 — Arrancar el contenedor

docker compose up -d

# Check the logs
docker compose logs -f openclaw

Actualizar con Docker

docker compose pull
docker compose up -d

Monte siempre su directorio data/ con bind-mount. Sin un volumen, perderá toda la memoria y el historial de conversaciones cuando el contenedor se reinicie.

4.Desde el código fuente

Compile desde el código fuente cuando quiera modificar el comportamiento del núcleo, contribuir upstream o ejecutar una rama pre-release. Este camino requiere experiencia como desarrollador.

Paso 1 — Clonar el repositorio

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

Paso 2 — Instalar dependencias

# Requires Node.js 20+ and pnpm
pnpm install

Paso 3 — Copiar y editar el archivo de entorno

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

Paso 4 — Compilar y arrancar

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

Actualizar desde el código fuente

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

Compilar desde el código fuente transforma TypeScript en JavaScript. El paso de build tarda entre 30 y 90 segundos según su hardware. Las compilaciones posteriores son más rápidas gracias al caché.

Post-instalación

OpenClaw ya está en marcha. Ahora configure su modelo de IA, conecte un canal de mensajería y verifique que todo funciona.

Configure su modelo de IA

OpenClaw soporta múltiples proveedores de IA. Defina su modelo preferido en el archivo .env o mediante el panel de control.

Proveedor	Modelos	Coste / msg
Anthropic	Claude Opus 4.6, Sonnet 4.5, Haiku 4.5	$0.001 – $0.05
OpenAI	GPT-5, GPT-5 mini	$0.002 – $0.03
Google	Gemini 3 Pro, Gemini 3 Flash	$0.001 – $0.02
DeepSeek	DeepSeek V3	~$0.005
Mistral	Mistral Large	~$0.01
Ollama (local)	Llama 4, Qwen 3, Mistral, and any GGUF model	Free

.envenv

# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434

Empiece con un modelo más económico como Haiku 4.5 o Gemini 3 Flash mientras hace pruebas. Cambie a un modelo más potente una vez configurados sus canales y su memoria.

Configure su primer canal (ejemplo WhatsApp)

OpenClaw soporta más de 191 integraciones. WhatsApp es el punto de partida más habitual. Así es como se conecta.

Cree una app de Meta Business

Vaya a developers.facebook.com. Cree una nueva app Business. Active el producto WhatsApp.

Obtenga su Phone Number ID y el token

En los ajustes de la API de WhatsApp, copie su Phone Number ID y genere un token de acceso permanente.

Añada las credenciales a .env

.envenv

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

Defina la URL del webhook

En el panel de Meta, configure su URL de webhook como https://su-dominio.com/api/webhook/whatsapp y use el token de verificación del paso 3.

Reinicie OpenClaw y envíe un mensaje de prueba

openclaw restart
# Or with Docker:
docker compose restart openclaw

Envíe su primer mensaje

Abra WhatsApp y envíe "Hola" al número conectado. Debería recibir una respuesta en 2 a 5 segundos. Si no tiene WhatsApp configurado, pruebe desde el panel de control.

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

Una respuesta correcta devuelve un JSON con la respuesta de la IA. Si obtiene un error, consulte la sección de resolución de problemas a continuación.

Errores comunes y soluciones

La mayoría de los problemas de instalación se agrupan en cinco categorías. Aquí le mostramos cómo solucionar cada uno.

Error: Puerto 3100 ya en uso

Otro proceso está ocupando el puerto predeterminado de OpenClaw.

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

Error: Versión de Node incompatible

OpenClaw requiere Node.js 20 o superior. Las versiones antiguas provocan errores de sintaxis al arrancar.

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

Error: Permiso denegado en Docker

Aparece el mensaje "permission denied while trying to connect to the Docker daemon socket".

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

Error: Problemas con el certificado SSL

Los proveedores de webhooks como Meta rechazan los endpoints HTTP. Necesita HTTPS.

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run

Si está detrás de Cloudflare, configure el modo SSL en "Full (Strict)" y use los certificados de origen de Cloudflare en lugar de Let's Encrypt.

Error: Sin memoria / proceso terminado

El OOM killer de Linux termina OpenClaw cuando el servidor se queda sin RAM.

# Check available memory
free -h

# Option A: Add swap space (quick fix)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

El modelo de IA se ejecuta de forma remota vía API. Los problemas de memoria provienen de la base de datos de memoria de OpenClaw y del proceso Node.js, no del modelo. 4 GB de RAM es el mínimo práctico.

Seguridad post-instalación

Una instancia de OpenClaw en producción sin seguridad es un riesgo. Los estudios muestran que el 93,4 % de las instancias públicas carecen de autenticación básica y 42.665 están expuestas en Internet. No se convierta en una estadística.

Checklist de seguridad (versión rápida)

Active la autenticación en .env: defina AUTH_ENABLED=true y AUTH_SECRET con una cadena aleatoria de 32 caracteres
Configure el firewall UFW: permita solo los puertos 22 (SSH), 80 (HTTP) y 443 (HTTPS)
Configure SSL/TLS con Let's Encrypt o certificados de origen de Cloudflare
Desactive el panel de control en producción o protéjalo detrás de autenticación
Mantenga OpenClaw actualizado: ejecute openclaw update o docker compose pull cada semana
Use un proxy inverso (Nginx o Caddy) delante de OpenClaw
Nunca exponga el puerto 3100 directamente a Internet

# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status

Esta es la versión abreviada. Para la auditoría de seguridad completa de 12 puntos que aplicamos a cada instalación de cliente, consulte nuestra Guía de seguridad & Checklist de seguridad.

Preguntas frecuentes

¿Necesita ayuda?

Nuestro equipo instala, protege y configura OpenClaw en su servidor. Memoria persistente, configuración multicanal y auditoría de seguridad de 12 puntos incluidas.

Ver planes Hacer una pregunta