Skip to content
Jaleo

Requisitos previos

Antes de empezar con la instalacion, necesitas tener listas estas cosas. Cada una es imprescindible para que Jaleo funcione.

Resumen rapido

Section titled “Resumen rapido”

| Requisito | Para que sirve | Recomendacion | |-----------|---------------|---------------| | VPS | Ejecutar jaleo-api y OpenClaw 24/7 | Piensa Solutions | | Dominio | HTTPS para OAuth y webfetch | Cualquier registrador | | Numero de WhatsApp | El bot necesita un numero propio | JuicySMS | | Spotify Premium | Cuenta para vincular al grupo | Spotify Premium | | App de Spotify Developer | Credenciales OAuth (Client ID + Secret) | Spotify Developer Dashboard | | Node.js 20+ | Ejecutar jaleo-api y OpenClaw | Via nvm o gestor de paquetes |

VPS (Servidor Virtual Privado)

Section titled “VPS (Servidor Virtual Privado)”

Jaleo necesita un servidor que este encendido 24/7. El bot de WhatsApp y la API deben estar siempre disponibles para recibir mensajes y responder.

Que necesita el VPS

Section titled “Que necesita el VPS”
  • Sistema operativo: Ubuntu 22.04 o superior (recomendado)
  • RAM: Minimo 1 GB (2 GB recomendados si usas un modelo de IA mas pesado)
  • Disco: 10 GB son suficientes
  • Conexion: IP publica con puerto 80 y 443 disponibles

Recomendacion: Piensa Solutions

Section titled “Recomendacion: Piensa Solutions”

Recomendamos Piensa Solutions porque ofrecen VPS a buen precio con buen soporte y datacenters en Espana. Un plan basico con 1 vCPU y 2 GB de RAM es suficiente.

Una vez tengas el VPS, conectate por SSH:

Terminal window
ssh root@tu-ip-del-vps

Actualizar el sistema

Section titled “Actualizar el sistema”

Lo primero tras conectarte:

Terminal window
apt update && apt upgrade -y

Instalar Node.js

Section titled “Instalar Node.js”

Recomendamos instalar Node.js 22 via nvm:

Terminal window
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
source ~/.bashrc
nvm install 22
node --version  # deberia mostrar v22.x.x

Dominio

Section titled “Dominio”

Necesitas un dominio que apunte a la IP de tu VPS. Esto es necesario para:

  • HTTPS: Spotify OAuth requiere HTTPS en la redirect URI. Caddy gestiona los certificados Let’s Encrypt automaticamente.
  • Webhook: OpenClaw necesita una URL publica para hacer webfetch.
  • OAuth: La pagina de vinculacion (https://tudominio.com/login) y el callback (https://tudominio.com/callback) deben ser accesibles desde el navegador del movil.

Configurar DNS

Section titled “Configurar DNS”

En el panel de tu registrador de dominios, crea un registro A:

Tipo: A
Nombre: @ (o el subdominio que quieras, ej: jaleo)
Valor: IP de tu VPS
TTL: 300

Por ejemplo, si tu dominio es miejemplo.com y la IP de tu VPS es 1.2.3.4:

jaleo.miejemplo.com  →  A  →  1.2.3.4

Espera unos minutos a que el DNS se propague antes de continuar.

Numero de WhatsApp

Section titled “Numero de WhatsApp”

El bot necesita su propio numero de WhatsApp. No puedes usar tu numero personal porque WhatsApp solo permite una sesion activa por numero (si vinculases tu numero a OpenClaw, se desconectaria de tu telefono).

Recomendacion: JuicySMS

Section titled “Recomendacion: JuicySMS”

Recomendamos JuicySMS para comprar numeros virtuales de WhatsApp. Son baratos, fiables y los numeros funcionan con WhatsApp Business API.

Alternativas:

  • Comprar una SIM prepaga en un comercio (si tienes una ranura libre)
  • Cualquier proveedor de numeros virtuales que soporte WhatsApp

Importante

Section titled “Importante”
  • El numero no debe tener una sesion de WhatsApp activa en otro dispositivo. OpenClaw se vinculaira como un dispositivo secundario, igual que cuando vinculas WhatsApp Web.
  • Si el numero es nuevo, es posible que WhatsApp te pida verificarte la primera vez que lo uses. OpenClaw mostrara un QR code para vincularlo.

Cuenta de Spotify Premium

Section titled “Cuenta de Spotify Premium”

La persona que vincule su cuenta al grupo debe tener Spotify Premium. Esto es obligatorio porque:

  • Solo Premium puede reproducir canciones a demanda
  • Solo Premium puede saltar canciones en cualquier momento
  • Solo Premium tiene control completo de la reproduccion

El resto de personas del grupo no necesitan Spotify. Las acciones se ejecutan sobre la sesion del usuario vinculado, asi que si tu tienes Premium y lo vinculas, tus amigos sin cuenta pueden controlar tu reproduccion.

App de Spotify Developer

Section titled “App de Spotify Developer”

Necesitas crear una aplicacion en el Spotify Developer Dashboard para obtener las credenciales OAuth (Client ID y Client Secret).

Te explicamos como hacerlo paso a paso en la siguiente seccion.

Modelo de IA

Section titled “Modelo de IA”

OpenClaw necesita un proveedor de modelo de lenguaje para interpretar los mensajes. Puedes usar cualquiera de estos:

| Proveedor | Modelo | Donde conseguirlo | |-----------|--------|-------------------| | DeepSeek | V4 Flash (recomendado, rapido y barato) | openclaw.ai o deepseek.com | | Anthropic | Claude | anthropic.com | | OpenAI | GPT-4o, Codex | openai.com |

DeepSeek V4 Flash es el mas recomendado porque es rapido, barato y funciona muy bien para este caso de uso. Lo puedes configurar directamente desde OpenClaw con una API key de OpenCode o con tu propia API key de DeepSeek.

Mas adelante, en la seccion de Instalar OpenClaw, te explicamos como configurar el modelo.

Checklist

Section titled “Checklist”

Antes de continuar, asegurate de tener:

  • [ ] Un VPS con Ubuntu y acceso SSH
  • [ ] Node.js 20+ instalado en el VPS
  • [ ] Un dominio apuntando a la IP del VPS
  • [ ] Un numero de WhatsApp dedicado (comprado en JuicySMS o similar)
  • [ ] Una cuenta de Spotify Premium
  • [ ] Una API key de un proveedor de IA (DeepSeek, Claude, etc.)

Una vez tengas todo, pasa a crear la app de Spotify.