Requisitos previos

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

En cualquier caso, puedes usar el proveedor que quieras para cada servicio. Las recomendaciones son simplemente los casos que hemos usado nosotros y que sabemos que funcionan.

Resumen rápido

Requisito	Para qué sirve	Recomendación
VPS	Ejecutar jaleo-api y OpenClaw 24/7	Piensa Solutions
Dominio	HTTPS para OAuth y webfetch	Cualquier registrador
Número de WhatsApp	El bot necesita un número 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	Vía nvm o gestor de paquetes

VPS (Servidor Virtual Privado)

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

Qué necesita el VPS

Sistema operativo: Ubuntu 22.04 o superior (recomendado)
RAM: Mínimo 1 GB (2 GB recomendados si usas un modelo de IA más pesado)
Disco: 10 GB son suficientes
Conexión: IP pública con puerto 80 y 443 disponibles

Recomendación: Piensa Solutions

Recomendamos Piensa Solutions porque ofrecen VPS a buen precio con buen soporte y datacenters en España. Un plan básico con 1 vCPU y 2 GB de RAM es suficiente.

Una vez tengas el VPS, conéctate por SSH:

ssh root@tu-ip-del-vps

Actualizar el sistema

Lo primero tras conectarte:

apt update && apt upgrade -y

Instalar Node.js

Recomendamos instalar Node.js 22 vía nvm:

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

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 automáticamente.
Webhook: OpenClaw necesita una URL pública para hacer webfetch.
OAuth: La página de vinculación (https://tudominio.com/login) y el callback (https://tudominio.com/callback) deben ser accesibles desde el navegador del móvil.

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.

Número de WhatsApp

El bot necesita su propio número de WhatsApp. No puedes usar tu número personal porque WhatsApp solo permite una sesión activa por número (si vinculases tu número a OpenClaw, se desconectaría de tu teléfono).

Recomendación: JuicySMS

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

Alternativas:

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

Importante

El número no debe tener una sesión de WhatsApp activa en otro dispositivo. OpenClaw se vinculará como un dispositivo secundario, igual que cuando vinculas WhatsApp Web.
Si el número es nuevo, es posible que WhatsApp te pida verificarte la primera vez que lo uses. OpenClaw mostrará un QR code para vincularlo.

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 reproducción

El resto de personas del grupo no necesitan Spotify. Las acciones se ejecutan sobre la sesión del usuario vinculado, así que si tú tienes Premium y lo vinculas, tus amigos sin cuenta pueden controlar tu reproducción.

App de Spotify Developer

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

Te explicamos cómo hacerlo paso a paso en la siguiente sección.

Modelo de IA

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

Proveedor	Modelo	Dónde conseguirlo
OpenCode	DeepSeek V4 Flash (recomendado, rápido y barato)	opencode.ai
Anthropic	Claude	anthropic.com
OpenAI	ChatGPT, GPT-4o, Codex	openai.com

Se recomienda OpenCode que es lo que hemos usado nosotros, pero hay otras alternativas: APIs directas de cada proveedor o suscripciones como ChatGPT o Claude.

Más adelante, en la sección de Instalar OpenClaw, te explicamos cómo configurar el modelo.

Checklist

Antes de continuar, asegúrate 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 número de WhatsApp dedicado (comprado en JuicySMS o similar)
[ ] Una cuenta de Spotify Premium
[ ] Una API key de un proveedor de IA (OpenCode, DeepSeek, Claude, etc.)

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