Volver a artículos
Inteligencia Artificial
10 min read

OpenClaw: cómo instalar y configurar el asistente IA más potente

Aprende a instalar OpenClaw en un VPS (Hetzner), configurar Telegram, memoria y voz gratuita con Groq para tu agente autónomo.

Portada de OpenClaw: cómo instalar y configurar el asistente IA más potente

Imagina una inteligencia artificial que no solo responde preguntas, sino que toma acción. Que navega por internet, gestiona tus archivos y ejecuta tareas complejas de forma autónoma. Eso es OpenClaw. Tras volverse viral por su capacidad de razonamiento y ejecución, este proyecto de código abierto nos permite tener un agente autónomo potente sin depender de suscripciones cerradas.

(Si aún no conoces la fascinante historia detrás de este proyecto y cómo fue adquirido por OpenSAI, te recomendamos leer primero ¿Qué es OpenClaw? El origen del Agente IA).

Advertencia importante: OpenClaw es un proyecto experimental. Está en desarrollo activo, puede tener errores y comportamientos inesperados. Úsalo con curiosidad, pero también con responsabilidad.

1. Elige tu infraestructura (¿Dónde vivirá tu IA?)

Para que tu IA funcione 24/7, necesitas un servidor virtual (VPS). En este tutorial usaremos:

  • Hetzner (Nuestra elección): El mejor equilibrio entre precio y potencia profesional.
  • Alternativas: Hardware viejo (laptop con Ubuntu), Mac Mini (M1/M2) por su eficiencia, o el plan gratuito de Oracle Cloud/AWS.

2. Configurando el servidor en Hetzner

  1. Registro: Crea tu cuenta en Hetzner Cloud.
  2. Añadir Servidor: Ubicación cercana, Imagen Ubuntu 24.04, Plan CX22.
  3. Seguridad (SSH): Genera tu llave en tu PC para entrar sin contraseña:
    • Mac/Linux: ssh-keygen -t ed25519
    • Windows: Usa el mismo comando en PowerShell.
    • Copia tu clave pública con cat ~/.ssh/id_ed25519.pub (o cat $HOME\.ssh\id_ed25519.pub) y pégala en Hetzner.

3. Preparando el Sistema (Seguridad y Optimización)

Entra a tu servidor:

ssh root@TU_IP_AQUI

Seguridad Inicial con Fail2ban

Protegemos el servidor contra ataques de fuerza bruta al SSH instalando este "guardia":

sudo apt update && sudo apt install -y fail2ban

# Configurar reglas básicas
# Ejecuta: sudo nano /etc/fail2ban/jail.local
# Pega lo siguiente:

[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 3

[sshd]
enabled = true

# Activar servicio
sudo systemctl enable fail2ban
sudo systemctl start fail2ban

RAM Virtual (Swap) de 4GB

Vital para que el bot no se cuelgue en planes económicos. Ejecuta estos comandos uno a uno:

sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
free -h

Para hacerlo permanente tras reinicios:

# Respalda: 
sudo cp /etc/fstab /etc/fstab.bak

# Agrega la instrucción: 
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Verifica: (Debes ver la línea al final).
cat /etc/fstab

Dependencias de Sistema y Bun (Para QMD)

# Navegador y herramientas base
sudo apt update && sudo apt install -y chromium-browser git curl sqlite3

# Instalar Bun (necesario para el motor de búsqueda semántica QMD)
curl -fsSL https://bun.sh/install | bash
source ~/.bashrc

4. Instalación de OpenClaw (Método Relámpago)

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

5. Onboarding: Configuración de APIs

Antes de conectar Telegram, ejecuta openclaw onboard. En este tutorial usaremos:

  • Suscripción de ChatGPT Plus ($20/mes): Para usar los modelos de OpenAI con prioridad.
  • OpenRouter: Para acceder a modelos como DeepSeek o Claude a precios mínimos.
  • Brave Search API: Ve a brave.com/search/api, regístrate y obtén tu Key. Tienes 1,000 búsquedas gratis al mes (suficiente para uso personal).
  • Groq API: Ve a console.groq.com para obtener una Key gratuita para el reconocimiento de voz (STT).

6. Conexión a Telegram y Pairing

  1. Obtener Token: Habla con @BotFather en Telegram, usa /newbot y guarda el Token.
  2. Configurar: En el asistente de onboarding, selecciona Telegram y pega tu Token.
  3. Pairing (Emparejamiento):
    • Envía "Hola" a tu bot en Telegram.
    • En la terminal corre: openclaw pairing list telegram.
    • Aprueba con: openclaw pairing approve telegram TU_CODIGO.

7. Instrucciones Directas al Agente (Tuning de Superpoderes)

Una vez que el bot te responda en Telegram, envíale estos comandos para configurarlo:

Memoria Avanzada y Personalidad

  • SOUL.md: Es súper importante. Crea un archivo llamado SOUL.md en la raíz del proyecto (puedes pegarlo vía SSH o FTP) y dile al bot:

"Actualiza tu alma con el contenido de SOUL.md".

  • Heartbeat (Ahorro): Dile al bot:

"Cambia el modelo del heartbeat a uno más económico configurando agents.defaults.heartbeat.model a gpt-4o-mini".

  • Speak-to-Text (Voz): Dile:

"Activa el Speak to Text usando mi API de Groq".

Evitar la Compactación de Memoria

Para que el bot no pierda el hilo, envíale:

"Activa estas configuraciones de memoria: set compaction.memoryflush.enabled to true y set memorysearch.experimental.sessionmemory to true"

Privacidad de Logs

"Asegúrate de que la información sensible como mis API keys estén siempre ocultas o 'redacted' en los logs de la consola".

8. Memoria Semántica con QMD (Backend Experimental)

Si quieres que el bot use búsqueda vectorial + BM25 (mucho más inteligente), activamos QMD:

  1. Instalar QMD CLI:
bun install -g https://github.com/tobi/qmd
  1. Activar: Dile al agente por Telegram:

"Cambia mi backend de memoria a QMD configurando memory.backend = 'qmd'".

9. Estrategia de Contexto: Discord

Para evitar que el contexto de la IA se sature y empiece a "alucinar", lo recomendable es usar Discord en lugar de un solo chat de Telegram.

  • Varios Canales: Crea canales específicos (#investigacion, #programacion, #ocio).
  • Contexto Dedicado: Cada canal tendrá su propio historial, permitiendo que la IA esté enfocada en una sola cosa a la vez.

(Si quieres saber cómo configurarlo con Discord paso a paso, puedo hacer un video dedicado).

10. Verificación y Acceso al Gateway

Salud del sistema:

openclaw health
openclaw status

Acceso Visual (Logs y Config)

Desde una nueva terminal en tu PC:

ssh -L 18789:127.0.0.1:18789 root@TU_IP_DEL_SERVIDOR

Luego entra en tu navegador a: http://127.0.0.1:18789

11. Manteniéndolo vivo (PM2)

npm install -g pm2
pm2 start openclaw -- start
pm2 save
pm2 startup

Conclusión

Ahora tienes un asistente autónomo con seguridad Fail2ban, memoria semántica QMD, búsqueda real con Brave y voz gratuita mediante Groq. Tu IA está lista para actuar 24/7 de forma independiente.

¿La terminal y los servidores no son lo tuyo pero quieres este nivel de eficiencia en tu negocio? En Lutiando nos especializamos en construir agentes a medida. Explora nuestros servicios corporativos de IA para Empresas o descubre nuestras Automatizaciones con IA para llevar tu productividad al límite sin escribir una sola línea de código.

L
Equipo Editorial