|

,

|

Como Instalar OpenClaw Paso a Paso: Guia Completa Desde Cero


como instalar OpenClaw en servidor VPS - rubenremote.com

Quieres instalar OpenClaw en tu propio servidor pero no sabes por donde empezar? Tranquilo, estas en el sitio correcto. Esta guia sobre como instalar OpenClaw te lo pone facil. En esta guia te voy a llevar de la mano, paso a paso, desde cero hasta tener tu agente de IA funcionando y listo para conectar con el mundo.

No necesitas ser programador ni experto en servidores. Si alguna vez has seguido una receta de cocina, puedes hacer esto. Solo necesitas un poco de paciencia y ganas de aprender algo nuevo. Al final de este articulo vas a tener OpenClaw corriendo en tu servidor, con su panel de administracion accesible desde el navegador.

Si todavia no tienes claro que es OpenClaw o para que sirve, te recomiendo leer primero mi guia completa sobre OpenClaw que es. Ahi explico todo desde cero. Ahora vamos al lio.

Ruben Sanchez - creador de agentes de IA

Nacido en Barcelona, curtido vendiendo propiedades en Italia, Londres y Dubai. Tras una decada en el sector inmobiliario internacional, lo aposte todo por la inteligencia artificial. Hoy construyo agentes autonomos que gestionan negocios reales, dirijo una agencia de SEO y AI visibility, y escribo sobre todo lo que aprendo en el camino.

No vengo del mundo tech. Aprendi a programar construyendo lo que necesitaba. Si estas leyendo esto, probablemente tu tambien puedes. Este blog existe para demostrarlo.

Como instalar OpenClaw: que necesitas antes de empezar

Antes de tocar nada, asegurate de tener estas 3 cosas:

  1. Un servidor VPS. Es un ordenador en la nube que alquilas por unos euros al mes. Necesitas minimo 2 vCPUs, 4GB de RAM y 40GB de disco. Proveedores recomendados: Contabo (el mas barato, desde 5 euros/mes), Hetzner (mejor relacion calidad-precio) o DigitalOcean (el mas facil de usar).
  2. Acceso SSH a tu servidor. Es la forma de conectarte a tu servidor desde tu ordenador. En Mac y Linux viene incluido. En Windows puedes usar PuTTY o la terminal de Windows (PowerShell).
  3. Una API key de un modelo de lenguaje. OpenClaw necesita un «cerebro» para pensar. Puedes usar Claude (de Anthropic), GPT-4 (de OpenAI), Gemini (de Google) o modelos gratuitos como Llama. Te recomiendo empezar con Claude porque tiene el mejor equilibrio entre calidad y precio.

El coste total de instalar OpenClaw? Entre 8 y 15 euros al mes contando el servidor y las llamadas a la API. Menos de lo que te gastas en cafes en una semana.

Paso 1: Preparar tu servidor

Una vez que tengas tu VPS contratado, te van a dar una direccion IP y unas credenciales. Conectate por SSH:

ssh root@tu-direccion-ip

Lo primero es actualizar el sistema. Esto es como hacer las actualizaciones de tu movil: importante para que todo funcione bien y seguro.

apt update && apt upgrade -y

Si estas en Ubuntu (que es lo que recomiendo), esto funciona directamente. Si usas otro sistema, el comando puede variar ligeramente pero la idea es la misma.

Paso 2: Instalar Docker y Docker Compose

Docker es la herramienta que hace posible instalar OpenClaw sin volverte loco con dependencias. Piensa en Docker como una caja que contiene todo lo que OpenClaw necesita para funcionar, empaquetado y listo.

Para instalar Docker en Ubuntu, ejecuta estos comandos uno por uno:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
apt install docker-compose-plugin -y

Verifica que Docker se instalo correctamente:

docker --version
docker compose version

Si ves numeros de version en ambos comandos, todo esta bien. Si no, revisa la documentacion oficial de Docker para tu sistema.

Paso 3: Descargar y configurar OpenClaw

Ahora viene lo bueno. Vamos a crear una carpeta para OpenClaw y descargar la configuracion:

mkdir openclaw && cd openclaw

Crea un archivo llamado docker-compose.yml. Este archivo le dice a Docker como instalar OpenClaw:

nano docker-compose.yml

Pega esta configuracion basica (puedes encontrar la version mas actualizada en la documentacion oficial de OpenClaw):

version: '3.8'
services:
  openclaw:
    image: ghcr.io/open-webui/open-webui:main
    container_name: openclaw
    ports:
      - "3000:8080"
    volumes:
      - openclaw-data:/app/backend/data
    environment:
      - WEBUI_SECRET_KEY=tu-clave-secreta-aqui
    restart: always

volumes:
  openclaw-data:

Cambia tu-clave-secreta-aqui por una clave aleatoria. Puedes generar una con este comando:

openssl rand -hex 32

Paso 4: Arrancar OpenClaw

Este es el momento de la verdad para instalar OpenClaw. Con un solo comando, Docker va a descargar todo lo necesario y arrancar tu agente:

docker compose up -d

La primera vez puede tardar unos minutos porque tiene que descargar la imagen (que pesa alrededor de 2GB). Ten paciencia. Cuando termine, verifica que esta corriendo:

docker ps

Deberias ver un contenedor llamado «openclaw» con estado «Up». Si lo ves, felicidades, tu agente ya esta vivo.

Ahora abre tu navegador y ve a http://tu-direccion-ip:3000. Deberia aparecer la pantalla de registro de OpenClaw. El primer usuario que se registre sera automaticamente el administrador.

Paso 5: Configurar tu modelo de lenguaje

OpenClaw ya esta corriendo, pero todavia no tiene «cerebro». Necesitas conectar un modelo de lenguaje. Ve a Settings > Connections en el panel de administracion.

Aqui tienes las opciones mas populares:

  • Claude (Anthropic): mi recomendacion personal. Excelente para conversaciones en espanol y muy bueno siguiendo instrucciones. Registrate en console.anthropic.com y copia tu API key.
  • GPT-4 (OpenAI): el mas conocido. Funciona muy bien pero es algo mas caro. Registrate en platform.openai.com.
  • Gemini (Google): buena opcion con un tier gratuito generoso. Ideal para empezar sin gastar.
  • Modelos locales (Ollama): si quieres privacidad total, puedes correr modelos como Llama o Mistral directamente en tu servidor. Necesitas mas RAM (minimo 8GB) pero no pagas nada por las llamadas a la API.

Pega tu API key en el campo correspondiente, selecciona el modelo que quieres usar y haz clic en guardar. Puedes probar que funciona enviando un mensaje de prueba desde el chat integrado.

Paso 6: Escribir el system prompt de tu agente

El system prompt es lo mas importante de tu agente. Es como el manual de instrucciones que le dice quien es, como debe hablar y que sabe (o no sabe). No es codigo, son instrucciones escritas en lenguaje normal.

Aqui tienes un ejemplo basico para un agente de atencion al cliente:

Eres el asistente virtual de [nombre de tu negocio].
Tu trabajo es responder preguntas de clientes de forma amable y profesional.

Lo que sabes:
- Nuestros servicios son: [lista de servicios]
- Horario: lunes a viernes de 9:00 a 18:00
- Precios: [rango de precios]
- Zona de servicio: [tu zona]

Reglas:
- Responde siempre en espanol
- Si no sabes algo, di que vas a consultar con el equipo
- Nunca inventes informacion
- Intenta recoger nombre y telefono del cliente

Cuanto mas detallado sea tu prompt, mejor sera tu agente. Dedicale tiempo a esto porque marca la diferencia entre un chatbot mediocre y uno que realmente ayuda a tus clientes. Si quieres profundizar en las posibilidades, echa un vistazo a mi articulo sobre que son las Skills de OpenClaw.

Paso 7: Poner OpenClaw detras de un dominio (opcional pero recomendado)

Acceder a tu agente por IP y puerto (http://123.456.789:3000) funciona, pero no es lo ideal. Lo mejor es ponerlo detras de un dominio con SSL. Para eso necesitas:

  1. Un dominio o subdominio (por ejemplo, agente.tudominio.com)
  2. Apuntar el DNS del dominio a la IP de tu servidor
  3. Instalar un reverse proxy como Nginx o Caddy
  4. Configurar un certificado SSL con Let’s Encrypt (gratis)

Caddy es mi opcion preferida porque configura SSL automaticamente. Con dos lineas de configuracion tienes HTTPS funcionando. Si prefieres Nginx, hay miles de tutoriales por ahi.

Paso 8: Conectar canales de mensajeria

Con OpenClaw instalado y configurado, el siguiente paso es conectarlo a los canales donde estan tus clientes. Los mas habituales son:

  • WhatsApp: necesitas una cuenta de WhatsApp Business y acceso a la API de Meta. Es el canal mas potente pero tambien el que mas burocracia requiere.
  • Telegram: el mas facil de configurar. Creas un bot con BotFather en 2 minutos y lo conectas a OpenClaw.
  • Discord: ideal si tu comunidad esta ahi. Se configura desde el Discord Developer Portal.

Tengo un articulo dedicado a como conectar OpenClaw con WhatsApp, Telegram y Discord donde explico cada integracion en detalle. Te recomiendo leerlo cuando tengas la instalacion base funcionando.

Errores comunes al instalar OpenClaw y como solucionarlos

Despues de instalar OpenClaw varias veces y ayudar a otras personas a hacerlo, estos son los problemas mas frecuentes cuando intentas instalar OpenClaw:

  • «Port 3000 already in use»: otro servicio esta usando ese puerto. Cambia el puerto en docker-compose.yml de «3000:8080» a «3001:8080» o el que prefieras.
  • La pagina no carga: revisa que el firewall de tu servidor permite trafico en el puerto 3000. En la mayoria de VPS tienes que abrir los puertos manualmente desde el panel de control.
  • «Unauthorized» al conectar la API: tu API key esta mal copiada o ha caducado. Generala de nuevo desde el panel del proveedor.
  • El contenedor se reinicia constantemente: probablemente te falta RAM. Revisa con docker logs openclaw para ver el error exacto. Si es falta de memoria, necesitas un VPS mas potente o activar swap.
  • Las respuestas son muy lentas: puede ser el modelo que elegiste (los modelos grandes como GPT-4 son mas lentos) o que tu servidor esta lejos del proveedor de API. Prueba con un modelo mas rapido como Claude Haiku o GPT-4-mini.

Siguientes pasos despues de instalar OpenClaw

Si has seguido todos los pasos para instalar OpenClaw y tu agente esta funcionando, felicidades. Ya tienes mas que el 95% de la gente que dice que «quiere hacer algo con IA». Ahora viene lo divertido: hacerlo realmente util.

Te recomiendo seguir con estos articulos:


Preguntas frecuentes sobre instalar OpenClaw

Necesito saber programar para instalar OpenClaw?

No. Si puedes copiar y pegar comandos en una terminal, puedes instalarlo. La guia es paso a paso y no requiere escribir codigo. Lo mas tecnico es editar un archivo de configuracion, que basicamente es cambiar un par de lineas de texto.


Cuanto cuesta el servidor para OpenClaw?

Desde 5 euros al mes en proveedores como Contabo o Hetzner. Para un uso normal (un agente respondiendo mensajes), un VPS con 2 vCPUs y 4GB de RAM es mas que suficiente. Si quieres correr modelos locales necesitaras mas RAM.


Puedo instalar OpenClaw en mi ordenador personal?

Si, puedes instalarlo localmente para probarlo. Solo necesitas Docker instalado en tu maquina. Pero para produccion (que responda clientes 24/7) necesitas un servidor que este siempre encendido.


Cuanto tarda la instalacion completa?

Si sigues esta guia, entre 30 minutos y 2 horas dependiendo de tu experiencia. La mayor parte del tiempo se va en esperar las descargas y en escribir un buen system prompt. La parte tecnica en si son 10 minutos de copiar y pegar comandos.


Tienes dudas sobre instalar OpenClaw? Escribeme, siempre estoy abierto a una conversacion.


Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *