Cómo ejecutar el asistente de IA Nanobot en un VPS

Nanobot es un asistente de IA personal ultraligero (¡con solo ~3.400 líneas de código!) inspirado en OpenClaw. Es perfecto para autoalojarlo en un VPS económico: tendrás tu propio asistente de IA disponible las 24 horas, los 7 días de la semana, accesible a través de Telegram, Discord o WhatsApp. Esta guía te lleva paso a paso por toda la configuración.

¿Qué es Nanobot?

🐈 Nanobot es un agente de IA minimalista que concentra una gran potencia en un paquete pequeño:

• Ultraligero: 99% más pequeño que las alternativas con todas las funciones
• Multicanal: Chatea mediante Telegram, Discord, WhatsApp o Feishu
• Con herramientas: Búsqueda web, ejecución de código, gestión de archivos
• Tareas programadas: Automatiza rutinas diarias
• Memoria: Recuerda el contexto entre conversaciones
• Soporte de LLM local: Ejecútalo con vLLM para total privacidad

GitHub: github.com/HKUDS/nanobot

Requisitos del VPS

Nanobot es ligero, por lo que no necesitas mucho:

Requisito	Mínimo	Recomendado
RAM	1 GB	2 GB
CPU	1 vCPU	2 vCPU
Almacenamiento	10 GB	20 GB
SO	Ubuntu 22.04	Ubuntu 24.04
Python	3.10+	3.12

Mejores opciones de VPS económico:

• Hostinger KVM1: $4,99/mes (4 GB RAM) ⭐ Mejor relación calidad-precio
• Hetzner CX22: €3,79/mes (2 vCPU, 4 GB RAM)
• Vultr Cloud: $5/mes (1 vCPU, 1 GB RAM)

Paso 1: Configuración inicial del servidor

Conéctate por SSH a tu nuevo VPS y ejecuta estos comandos:

# Update system
sudo apt update && sudo apt upgrade -y

# Install Python and pip
sudo apt install python3 python3-pip python3-venv -y

# Install uv (fast Python package manager)
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

Paso 2: Instalar Nanobot

Elige uno de estos métodos de instalación:

Opción A: Usando uv (Recomendado)

uv tool install nanobot-ai

Opción B: Usando pip

pip install nanobot-ai

Opción C: Desde el código fuente (Últimas funciones)

git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .

Paso 3: Inicializar y configurar

Ejecuta el comando de incorporación:

nanobot onboard

Esto crea ~/.nanobot/config.json. Edítalo con tus claves API:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-YOUR-KEY-HERE"
    }
  },
  "agents": {
    "defaults": {
      "model": "anthropic/claude-sonnet-4"
    }
  },
  "tools": {
    "web": {
      "search": {
        "apiKey": "BSA-YOUR-BRAVE-KEY"
      }
    }
  }
}

Obtener claves API:

• OpenRouter: openrouter.ai/keys (para acceso al LLM)
• Brave Search: brave.com/search/api/ (opcional, para búsqueda web)

Paso 4: Probar que funciona

Ejecuta una prueba rápida:

nanobot agent -m "Hello! What can you help me with?"

Deberías ver una respuesta de la IA. Si funciona, ¡estás listo para el siguiente paso!

Paso 5: Conectar el bot de Telegram

La mejor forma de chatear con Nanobot es a través de Telegram:

1. Crear un bot de Telegram:

• Abre Telegram, busca @BotFather
• Envía /newbot y sigue las instrucciones
• Copia el token del bot

2. Obtener tu ID de usuario:

• Busca @userinfobot en Telegram
• Te mostrará tu ID de usuario numérico

3. Actualizar la configuración:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

4. Iniciar el gateway:

nanobot gateway

¡Ahora envía un mensaje a tu bot en Telegram y Nanobot responderá! 🎉

Paso 6: Ejecutar como servicio (24/7)

Para mantener Nanobot en ejecución después de desconectarte, crea un servicio systemd:

sudo nano /etc/systemd/system/nanobot.service

Pega esto:

[Unit]
Description=Nanobot AI Assistant
After=network.target

[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME
ExecStart=/home/YOUR_USERNAME/.local/bin/nanobot gateway
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Habilita e inicia el servicio:

sudo systemctl daemon-reload
sudo systemctl enable nanobot
sudo systemctl start nanobot

Comprueba el estado: sudo systemctl status nanobot

No olvides asegurar tu VPS antes de exponerlo a internet.

Alternativa con Docker

¿Prefieres Docker? Aquí tienes una configuración rápida:

# Create config directory
mkdir -p ~/.nanobot

# Create config.json with your settings
nano ~/.nanobot/config.json

# Run with Docker
docker run -d \
  --name nanobot \
  --restart always \
  -v ~/.nanobot:/root/.nanobot \
  ghcr.io/hkuds/nanobot:latest \
  gateway

Ver logs: docker logs -f nanobot

Desglose de costes

Costes mensuales:

Componente	Coste
VPS (Hostinger)	$4,99
OpenRouter API	~$5-20 (según uso)
Brave Search	Nivel gratuito disponible
Total	~$10-25/mes

Consejos para reducir costes:

• Usa anthropic/claude-haiku para tareas sencillas (~10 veces más barato)
• Usa minimax/minimax-m2 como opción económica
• Ejecuta un LLM local con vLLM para $0 en costes de API (necesita VPS con 8 GB+ de RAM)

Preguntas frecuentes

¿Cuál es la diferencia entre Nanobot y OpenClaw?

Nanobot está inspirado en OpenClaw pero es un 99% más pequeño (~3.400 líneas frente a más de 430k líneas). Está diseñado para la simplicidad y facilidad de modificación, mientras que OpenClaw ofrece funciones más avanzadas.

¿Puedo ejecutar Nanobot en un VPS de $5?

¡Sí! Nanobot es muy ligero. Un VPS con 1 GB de RAM es suficiente para un uso básico. Para cargas de trabajo más intensas o múltiples canales, opta por 2 GB+ de RAM.

¿Qué modelo de LLM debo usar?

Para mejores resultados, usa Claude claude-sonnet-4 o claude-opus-4-5 a través de OpenRouter. Para uso económico, prueba minimax-m2 o ejecuta un LLM local con vLLM.

¿Son privados mis datos?

Tus conversaciones pasan a través del proveedor de LLM (OpenRouter/OpenAI). Para total privacidad, ejecuta un LLM local usando vLLM en un VPS más potente (8 GB+ de RAM): consulta nuestra guía de mejor VPS para Ollama para el alojamiento de LLM local.

¿Puedo usar Discord o WhatsApp en lugar de Telegram?

¡Sí! Nanobot es compatible con Telegram, Discord, WhatsApp y Feishu. Consulta el repositorio de GitHub para obtener instrucciones de configuración específicas por canal.