Instalar OpenClaw en un VPS requiere un servidor Linux (se recomienda Ubuntu 22.04 o 24.04 LTS), acceso SSH, una clave de API para un modelo de IA u Ollama para inferencia local y credenciales para al menos una plataforma de mensajería. La página oficial documenta un proceso de tres pasos: elegir un plan, acceder por SSH al asistente de configuración inicial e iniciar OpenClaw desde la terminal o la interfaz de control mediante un túnel SSH. La instalación manual desde el repositorio de OpenClaw en GitHub sigue un proceso similar. Verifica todos los comandos en el README del repositorio antes de ejecutarlos.
Opción preinstalada: hosting de OpenClaw de Contabo
La forma más rápida de poner en marcha una instancia de OpenClaw es contratar un plan VPS de Contabo con OpenClaw preinstalado. La página oficial confirma este proceso de tres pasos:
- Elige un plan en contabo.com/es/openclaw-hosting/. Los planes están clasificados por caso de uso (uso personal, usuario intensivo, despliegue para equipos y escala empresarial). Consulta la página para conocer los precios actuales.
- Cuando se despliegue el servidor, conéctate por SSH y ejecuta el asistente de configuración inicial. Agrega las claves de API de tu proveedor de IA, que se cifran durante la configuración, conecta tus apps de mensajería y configura tus preferencias.
- Inicia la interfaz de terminal para interactuar directamente con tu asistente o accede de forma segura a la interfaz de control mediante un túnel SSH.
Contabo ofrece soporte técnico para la infraestructura del VPS y la instalación inicial con un clic. Configurar, mantener y solucionar problemas de OpenClaw es responsabilidad del usuario. Para dudas sobre la aplicación, consulta la documentación de OpenClaw y su comunidad de GitHub.
Instalación manual: requisitos previos
Si prefieres instalar OpenClaw desde su repositorio de GitHub, reúne lo siguiente antes de comenzar:
- Un VPS Linux. Se recomienda Ubuntu 22.04 LTS o 24.04 LTS. Consulta las distribuciones compatibles en el README de OpenClaw en GitHub.
- Acceso root por SSH o acceso sudo.
- Suficiente RAM para el modelo de IA que planeas usar. Consulta la sección sobre requisitos de RAM más adelante.
- Una clave de API para un modelo de IA de OpenAI, Anthropic o Google, o un plan para usar Ollama sin costos de API mediante inferencia local.
- Credenciales de la plataforma de mensajería: token de bot o URL de webhook para la app que elijas.
- Opcionalmente, un nombre de dominio que apunte a tu VPS para contar con una URL sencilla para el gateway.
Paso 1: prepara tu VPS
- Actualiza el sistema:
sudo apt update && sudo apt upgrade -y - Crea un usuario que no sea root para ejecutar OpenClaw:
adduser openclaw-user
usermod -aG sudo openclaw-user
Cambia a este usuario. Nunca ejecutes OpenClaw como root. - Configura el firewall UFW:
sudo ufw default deny incoming
sudo ufw allow OpenSSH
sudo ufw enable - Activa el Firewall de Contabo a nivel de red antes de abrir otros puertos: new.contabo.com → Network Services → Firewall → bloquea de forma predeterminada todo el tráfico entrante.
Paso 2: instala OpenClaw
Confirma los comandos exactos en el repositorio de OpenClaw en GitHub antes de ejecutarlos. El proyecto se desarrolla activamente y los pasos de instalación cambian entre versiones. El proceso general es el siguiente:
- Clona el repositorio. Confirma la URL actual en la documentación oficial de OpenClaw:
git clone https://github.com/[openclaw-repo] openclaw
cd openclaw - Instala el entorno de ejecución requerido. Consulta el README para saber si tu versión necesita Node.js o Python:
# Node.js example:
npm install - Copia la plantilla del archivo de entorno y configúrala:
cp .env.example .env
nano .env
Agrega la clave de API de tu modelo de IA y las credenciales del gateway. Guarda el archivo. - Completa los pasos adicionales de configuración indicados en el README del repositorio.
Paso 3: conecta tu app de mensajería
La página oficial confirma la compatibilidad con estas plataformas de mensajería: WhatsApp, Telegram, Discord, Slack, Signal, iMessage y Microsoft Teams.
Telegram
Crea un bot con @BotFather en Telegram: envía /newbot, sigue las indicaciones y copia el token del bot. Agrega el token a tu archivo .env. Confirma el nombre exacto de la variable en la documentación de OpenClaw.
Discord
Crea una aplicación de Discord en discord.com/developers/applications, agrega un bot y copia el token en .env. Genera una URL de invitación OAuth2 con el alcance de bot y los permisos necesarios. Después, invita el bot a tu servidor. Confirma los permisos requeridos en la documentación de OpenClaw.
Slack
Crea una app de Slack en api.slack.com/apps. Usa el método de manifiesto de app si está disponible. Copia el token del bot y el secreto de firma en .env. Consulta la plantilla actual del manifiesto de Slack en la documentación de OpenClaw.
El método de integración con WhatsApp puede cambiar. Antes de continuar, consulta el repositorio de OpenClaw en GitHub para confirmar el método compatible actual, ya que las políticas de la plataforma afectan las opciones disponibles.
Paso 4: configura tu modelo de IA
Agrega a .env las credenciales del modelo de IA que elegiste. La página oficial confirma los cuatro proveedores siguientes:
| Proveedor de IA | Variable de entorno | Dónde obtener la clave |
|---|---|---|
| Anthropic Claude | ANTHROPIC_API_KEY (confirma el nombre de la variable en la documentación) | console.anthropic.com/settings/keys |
| OpenAI GPT | OPENAI_API_KEY (confirma el nombre de la variable en la documentación) | platform.openai.com/api-keys |
| Google Gemini | GEMINI_API_KEY (confirma el nombre de la variable en la documentación) | aistudio.google.com/app/apikey |
| Ollama (local) | OLLAMA_BASE_URL, normalmente http://localhost:11434 | Instala Ollama por separado. Consulta las instrucciones siguientes |
Nota de la sección oficial de preguntas frecuentes: ‘pagarás por token. Supervisa el uso de tokens, ya que estos costos pueden aumentar rápidamente con un agente autónomo como OpenClaw.’ Ollama elimina este costo porque ejecuta los modelos de forma local en el VPS.
Configurar Ollama para inferencia local
- Instala Ollama en el mismo VPS:
curl -fsSL https://ollama.com/install.sh | sh - Descarga un modelo:
ollama pull llama3 - Define el endpoint de Ollama en .env:
OLLAMA_BASE_URL=http://localhost:11434
Confirma el nombre exacto de la variable en la documentación de OpenClaw.
Requisitos de RAM para inferencia local: aproximadamente 8 GB para un modelo con 7B parámetros y 16 GB para uno con 13B. Consulta las especificaciones de RAM de cada plan en contabo.com/en/openclaw-hosting/.
Paso 5: configura tu dominio y SSL
La sección oficial de preguntas frecuentes confirma: ‘Sí. Apunta tu dominio a la dirección IP de tu VPS y configura SSL con Let’s Encrypt para acceder de forma segura a tu instancia de OpenClaw.’
- Desde el registrador, apunta el registro A de tu dominio a la IP de tu VPS.
- Instala certbot:
sudo apt install certbot - Obtén un certificado SSL:
sudo certbot certonly –standalone -d yourdomain.com - Configura OpenClaw para usar el certificado. Confirma el método de configuración en la documentación de OpenClaw.
- Abre el puerto del gateway en UFW. Sustituye 3000 por tu puerto real:
sudo ufw allow 3000
Agrega también la regla al Firewall de Contabo en new.contabo.com.
Paso 6: inicia OpenClaw y pruébalo
Ejecuta OpenClaw como un servicio systemd para que se reinicie automáticamente después de reiniciar el servidor. Crea un archivo de servicio en /etc/systemd/system/openclaw.service. Confirma el comando ExecStart y el directorio de trabajo correctos en la documentación de OpenClaw:
[Unit]
Description=OpenClaw AI Agent
After=network.target
[Service]
Type=simple
User=openclaw-user
WorkingDirectory=/home/openclaw-user/openclaw
ExecStart=/usr/bin/node index.js
Restart=on-failure
RestartSec=5
[Install]
WantedBy=multi-user.target- Habilita e inicia el servicio:
sudo systemctl enable openclaw
sudo systemctl start openclaw - Consulta el estado:
sudo systemctl status openclaw - Envía un mensaje de prueba desde tu app de mensajería. Si recibes una respuesta, todos los componentes funcionan correctamente.
Problemas comunes:
- La app de mensajería no responde: comprueba que el puerto del gateway esté abierto tanto en UFW como en el Firewall de Contabo.
- Error de clave de API: confirma que la clave esté definida correctamente en .env, sin espacios ni comillas adicionales.
- El modelo de Ollama no carga: ejecuta free -h para comprobar la RAM disponible. Descarga un modelo más pequeño si es necesario.
Preguntas frecuentes sobre la instalación de OpenClaw en un VPS
¿Cómo instalo OpenClaw en Ubuntu?
Actualiza el sistema, clona el repositorio de OpenClaw desde GitHub, instala el entorno de ejecución requerido (Node.js o Python; consulta el README actual), configura .env con la clave de API de tu modelo de IA y las credenciales de mensajería e inicia OpenClaw como un servicio systemd. También puedes usar un plan de Contabo con OpenClaw preinstalado para omitir la configuración manual. Confirma siempre los comandos de instalación en el repositorio de OpenClaw en GitHub antes de ejecutarlos.
¿Cuánta RAM necesita OpenClaw?
Con proveedores de IA en la nube (OpenAI, Anthropic y Google), OpenClaw necesita poca RAM porque el procesamiento de IA ocurre en los servidores del proveedor, no en tu VPS. Con Ollama para inferencia local, calcula aproximadamente 8 GB para un modelo 7B y 16 GB para uno 13B. Consulta las especificaciones de RAM de cada plan en contabo.com/en/openclaw-hosting/.
¿Puedo ejecutar OpenClaw sin una clave de API?
Sí, mediante Ollama para inferencia local. Instala Ollama en el mismo VPS, descarga un modelo (ollama pull llama3) y configura OpenClaw para usar el endpoint local de Ollama. No tendrás costos de API y los datos no saldrán de tu servidor más allá de tu propio VPS. La desventaja es que los modelos locales requieren más RAM y su calidad puede variar frente a GPT-4 o Claude.
¿Contabo ofrece soporte para configurar OpenClaw?
La sección oficial de preguntas frecuentes confirma que Contabo ofrece soporte técnico para la infraestructura del VPS: hardware del servidor, red e instalación inicial de OpenClaw con un clic. Después de instalarlo, el usuario debe configurar, mantener y solucionar los problemas de la aplicación. Para preguntas específicas sobre OpenClaw, consulta la documentación oficial y la comunidad de GitHub.
Aviso: las especificaciones, funciones y precios de los productos mencionados en este artículo pueden cambiar y variar según la región, el periodo de facturación y las promociones vigentes. Consulta el sitio web oficial de cada proveedor o marca para conocer las cifras, los precios y los tipos de cambio locales actuales.
