Cómo Instalar Clawdbot en un VPS

Alrededor de 7 min

Cómo Instalar Clawdbot en un VPS

Clawdbot es un asistente personal de IA de código abierto y autoalojado que se conecta a tus plataformas de mensajería favoritas. A diferencia de los asistentes de IA basados en la nube como ChatGPT, Clawdbot se ejecuta completamente en tu infraestructura, dándote control total sobre tus datos y privacidad. En este artículo, te guiaremos a través del proceso de instalación de Clawdbot en un VPS usando Node.js. Recomendamos usar LightNode como tu proveedor de VPS.

¿Qué es Clawdbot?

Clawdbot es un potente asistente personal de IA que vive dentro de tus aplicaciones y plataformas de mensajería favoritas. Se conecta a WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Microsoft Teams, Google Chat y más, transformando los Modelos de Lenguaje Grande en un compañero verdaderamente personal y siempre disponible. Las características clave incluyen:

Soporte multiplataforma: Funciona en más de 10 plataformas de mensajería
Memoria persistente: Recuerda tus preferencias y conversaciones pasadas con el tiempo
Acciones proactivas: Puede realizar acciones, establecer recordatorios y enviar notificaciones
Autoalojado: Control total sobre la propiedad de datos y privacidad
Personalizable: Extensible con habilidades y herramientas
Siempre activo: Funciona 24/7 en tu VPS o máquina local

Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

Un servidor VPS: Puedes elegir entre varios proveedores de servicios en la nube. Recomendamos LightNode por su excelente rendimiento y cobertura global.
Conocimientos básicos de línea de comandos: Familiaridad con comandos de terminal será útil.
Node.js instalado: Asegúrate de tener Node.js 22 o superior instalado en tu servidor.
Requisitos mínimos del sistema: 2GB de RAM, 1 vCPU, 10GB de espacio en disco (se recomiendan 4GB de RAM para uso en producción).

Por Qué Recomendamos LightNode VPS

LightNode es una excelente opción para alojar Clawdbot por varias razones:

Beneficios Clave de LightNode

Precios accesibles: Planes desde $7.71/mes con facturación por hora, permitiéndote probar sin compromisos a largo plazo.
Más de 40 ubicaciones globales: Centros de datos en 6 continentes incluyendo EE.UU., Europa, Asia, Medio Oriente y África, asegurando baja latencia para usuarios en todo el mundo.
Alto rendimiento: Almacenamiento NVMe SSD y CPUs de alta frecuencia que ofrecen un excelente rendimiento para cargas de trabajo de IA.
Garantía de 99.95% de uptime: Infraestructura confiable con acceso BGP local que asegura que tu asistente esté siempre disponible.
Facturación flexible: Paga solo por lo que usas con facturación por hora, ideal para pruebas y escalado.
Amigable para desarrolladores: Acceso root completo, despliegue instantáneo y soporte para Linux y Windows.
Snapshots gratuitos: Un snapshot gratuito por VPS para copias de seguridad y recuperación fáciles.
Bono para nuevos usuarios: Obtén hasta $15 en créditos gratis en tu primera recarga.

Configuración Recomendada de LightNode para Clawdbot

Componente	Especificación	Costo Mensual
Plan	Agency	$14.70/mes
CPU	2 vCPU	-
RAM	4GB DDR4	-
Almacenamiento	50GB NVMe SSD	-
Ancho de banda	2TB	-
Ubicación	Singapur, Hong Kong o Silicon Valley	-

Esta configuración proporciona recursos suficientes para las operaciones de Clawdbot y permite espacio para crecer a medida que aumente tu uso.

Comienza con LightNode

Paso 1: Configurando tu VPS

Lanzar instancia: Inicia sesión en LightNode y crea una nueva instancia VPS. Recomendamos elegir una ubicación cercana a tus usuarios principales para una latencia óptima. Para acceso global, Singapur o Hong Kong son excelentes opciones para usuarios asiáticos, mientras que Silicon Valley funciona bien para usuarios en Norteamérica.
Elegir sistema operativo: Selecciona Ubuntu 22.04 LTS (recomendado) o Ubuntu 24.04. Estas versiones tienen excelente soporte para Node.js y están ampliamente probadas.
Acceso SSH: Usa un cliente SSH para acceder a tu servidor:
```
ssh username@your_server_ip
```

Paso 2: Instalando Node.js

Clawdbot requiere Node.js versión 22 o superior. Aquí te mostramos cómo instalarlo en Ubuntu:

# Actualizar listas de paquetes
sudo apt update

# Instalar Node.js 22 desde el repositorio NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# Verificar instalación
node --version
# Debería mostrar: v22.x.x

Alternativamente, puedes usar NVM (Node Version Manager) para mayor flexibilidad:

# Instalar NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc

# Instalar Node.js 22
nvm install 22
nvm use 22

# Verificar instalación
node --version

Paso 3: Instalando Clawdbot

Hay varios métodos de instalación disponibles. Elige el que mejor se adapte a tus necesidades.

Método 1: Script Instalador Oficial (Recomendado para principiantes)

El script instalador es el método más sencillo y maneja automáticamente las dependencias:

# Descargar y ejecutar el instalador
curl -fsSL https://clawd.bot/install.sh | bash

Este comando hará lo siguiente:

Detectar tu sistema operativo
Asegurar que Node.js 22+ esté instalado
Instalar Clawdbot globalmente vía npm
Configurar las rutas necesarias
Ejecutar el comando doctor para verificar la instalación

Método 2: Instalación global con npm

Para usuarios familiarizados con npm:

# Instalar Clawdbot globalmente
npm install -g clawdbot@latest

# O usando pnpm (más rápido)
pnpm add -g clawdbot@latest

# Verificar instalación
clawdbot --version

Método 3: Instalar desde el código fuente (Para desarrolladores)

# Clonar el repositorio
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Instalar dependencias
pnpm install

# Construir la interfaz de usuario
pnpm ui:build

# Construir el proyecto
pnpm build

# Ejecutar el asistente de configuración inicial
./dist/entry.js onboard --install-daemon

Método 4: Instalación con Docker (Opcional)

Para despliegue en contenedores:

# Clonar el repositorio
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

# Ejecutar el script de configuración Docker
./docker-setup.sh

Paso 4: Ejecutando el asistente de configuración inicial

Después de la instalación, ejecuta el asistente para configurar Clawdbot:

# Iniciar el asistente interactivo
clawdbot onboard --install-daemon

El asistente te guiará por:

Configuración del Gateway: Elige modo gateway local o remoto y configura el puerto del gateway (por defecto: 18789).
Configuración de autenticación: Configura tu proveedor de modelo de IA.
- Anthropic (Claude): clave API o OAuth (recomendado)
- OpenAI (ChatGPT/Codex): clave API
- Otros proveedores: endpoints personalizados y claves API
Configuración de canales: Configura plataformas de mensajería:
- WhatsApp: inicio de sesión con código QR
- Telegram: token de bot desde @BotFather
- Discord: token de bot desde el Portal de Desarrolladores de Discord
- Slack: OAuth o token de bot
Instalación del servicio: Instala el Gateway como servicio en segundo plano (systemd en Linux).
Identidad del agente: Configura la personalidad y comportamiento predeterminado de tu asistente.

Paso 5: Iniciando el Gateway

Después de completar el asistente, el Gateway debería iniciarse automáticamente. Puedes verificar su estado con:

# Verificar estado del gateway
clawdbot gateway status

# Ver logs
clawdbot logs --follow

# Verificar salud
clawdbot health

Inicio manual (si el servicio no está corriendo)

# Iniciar gateway en primer plano
clawdbot gateway --port 18789 --verbose

Gestión del servicio

# Iniciar el servicio
systemctl --user start clawdbot-gateway.service

# Detener el servicio
systemctl --user stop clawdbot-gateway.service

# Reiniciar el servicio
systemctl --user restart clawdbot-gateway.service

# Habilitar servicio para iniciar al arrancar
systemctl --user enable clawdbot-gateway.service

# Ver logs del servicio
journalctl --user -u clawdbot-gateway -f

Paso 6: Accediendo al Panel de Control

La interfaz de control de Clawdbot es accesible vía navegador web:

http://your_server_ip:18789/

Si configuraste autenticación durante el asistente, necesitarás proporcionar el token del gateway para acceder al panel.

Acceso remoto vía túnel SSH

Para acceso remoto seguro:

# Configurar túnel SSH desde tu máquina local
ssh -N -L 18789:127.0.0.1:18789 username@your_server_ip

# Luego acceder localmente
http://localhost:18789/

Paso 7: Conectando tu primer canal

Para conectar WhatsApp:

# Generar y mostrar código QR
clawdbot channels login

# Escanear con WhatsApp:
# Configuración → Dispositivos vinculados → Vincular un dispositivo

Después de escanear, tu WhatsApp se conectará a Clawdbot.

Crea un bot enviando un mensaje a @BotFather en Telegram
Sigue las indicaciones para crear un nuevo bot
Copia el token del bot proporcionado
Añade el bot a Clawdbot:

clawdbot channels add --channel telegram --token "tu_token_de_bot_aquí"

Discord

Ve al Portal de Desarrolladores de Discord
Crea una nueva aplicación
Activa el bot en la pestaña "Bot"
Copia el token del bot
Invita al bot a tu servidor de Discord con los permisos adecuados
Añade a Clawdbot:

clawdbot channels add --channel discord --token "tu_token_de_bot_de_discord"

Paso 8: Configurando la seguridad de mensajes directos (DM)

Por defecto, Clawdbot usa un modo de emparejamiento para mensajes directos, lo que significa que remitentes desconocidos reciben un código de emparejamiento y sus mensajes no se procesan hasta ser aprobados.

# Listar solicitudes de emparejamiento pendientes
clawdbot pairing list whatsapp

# Aprobar una solicitud de emparejamiento
clawdbot pairing approve whatsapp <código_de_emparejamiento>

# Ver emparejamientos aprobados
clawdbot pairing list whatsapp --approved

Puedes modificar este comportamiento en el archivo de configuración en ~/.clawdbot/clawdbot.json.

Paso 9: Probando tu configuración

Envía un mensaje de prueba para verificar que todo funcione:

# Enviar mensaje de prueba
clawdbot message send --to +15555550123 --message "¡Hola desde Clawdbot!"

# O prueba vía Telegram
clawdbot message send --to @tu_usuario_telegram --message "¡Hola!"

Alternativamente, envía un mensaje directamente a tu WhatsApp/Telegram/Discord conectado, y tu asistente Clawdbot debería responder.

Paso 10: Configurando Nginx (Opcional)

Para uso en producción, recomendamos configurar un proxy inverso con Nginx para mejorar la seguridad y gestionar certificados SSL.

Instalar Nginx

sudo apt install -y nginx

Configurar Nginx

Edita el archivo de configuración de Nginx:

sudo nano /etc/nginx/sites-available/clawdbot

Agrega la siguiente configuración:

server {
    listen 80;
    server_name your-domain.com;  # Reemplaza con tu dominio

    location / {
        proxy_pass http://localhost:18789;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

Habilitar la configuración

# Crear enlace simbólico
sudo ln -s /etc/nginx/sites-available/clawdbot /etc/nginx/sites-enabled/

# Probar configuración de Nginx
sudo nginx -t

# Reiniciar Nginx
sudo systemctl restart nginx

Añadir SSL con Certbot (Recomendado)

# Instalar Certbot
sudo apt install -y certbot python3-certbot-nginx

# Obtener certificado SSL
sudo certbot --nginx -d your-domain.com

# Certbot configurará automáticamente Nginx con SSL

Después de esto, tu Clawdbot será accesible en:

https://your-domain.com/

Solución de Problemas Comunes

El Gateway no inicia

Si el gateway no arranca:

# Verificar errores de configuración
clawdbot doctor

# Ver logs detallados
journalctl --user -u clawdbot-gateway -n 50

Errores por falta de memoria

En VPS con 2GB de RAM, podrías encontrar errores de falta de memoria durante actualizaciones. Añade un archivo swap:

# Crear archivo swap de 2GB
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# Hacer swap persistente
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

Puerto ya en uso

Si el puerto 18789 ya está en uso:

# Encontrar qué está usando el puerto
sudo lsof -i :18789

# O usar un puerto diferente
clawdbot gateway --port 18889

El bot no responde

Si tu bot no responde:

Verifica estado del Gateway: clawdbot gateway status
Revisa configuración de canales: Asegúrate que los tokens sean correctos y los canales estén habilitados
Verifica autenticación: Confirma que las claves API sean válidas
Revisa logs: clawdbot logs --follow para buscar mensajes de error

Actualizando Clawdbot

Para actualizar a la última versión:

# Ejecutar nuevamente el instalador
curl -fsSL https://clawd.bot/install.sh | bash

# O actualizar vía npm
npm update -g clawdbot@latest

# Reiniciar el gateway
clawdbot gateway restart

# Verificar estado
clawdbot health

Conclusión

Instalar Clawdbot en un VPS es un proceso sencillo que te brinda un asistente de IA potente y autoalojado accesible en múltiples plataformas de mensajería. Con los precios accesibles, cobertura global e infraestructura de alto rendimiento de LightNode, puedes desplegar tu asistente personal de IA con confianza.

Siguiendo esta guía, deberías tener Clawdbot funcionando en tu VPS en unos 20-30 minutos, ofreciéndote un compañero de IA siempre disponible que respeta tu privacidad y te da control total sobre tus datos.

Para personalizaciones avanzadas y características adicionales, consulta la documentación oficial en la página de GitHub de Clawdbot y explora las discusiones de la comunidad para más consejos e ideas.

Recursos Adicionales

Documentación Oficial de Clawdbot
Repositorio GitHub de Clawdbot
LightNode VPS - Proveedor VPS recomendado
Comunidad Discord de Clawdbot
Marketplace de Skills - Extiende tu asistente con habilidades adicionales