8. Añadir el bot a un grupo

Ya tenemos todo configurado. Ahora vamos a probarlo.

Paso 1: Añadir el número del bot a tus contactos

En tu teléfono personal (no el del bot):

1. Abre la app de contactos
2. Crea un nuevo contacto con el número del bot (el que compraste en JuicySMS)
3. Guarda el contacto con el nombre “Jaleo” (o el que prefieras)

Paso 2: Crear o usar un grupo de WhatsApp

1. Abre WhatsApp
2. Crea un grupo nuevo o abre uno existente
3. Añade el contacto de Jaleo como participante del grupo

El bot debería aparecer en la lista de participantes del grupo.

Paso 3: Escribir el primer mensaje

Escribe en el grupo:

pon música

Como el grupo aún no está vinculado a Spotify, el bot debería responder con algo como:

“No tienes Spotify vinculado. Entra aquí: https://tudominio.com/login?groupId=120363…

Paso 4: Vincular Spotify

1. Toca el enlace que el bot envió
2. Se abrirá el navegador y te redirigirá a la página de autorización de Spotify
3. Inicia sesión con tu cuenta de Spotify Premium
4. Autoriza los permisos (reproducción, lectura del estado, canción actual)
5. Spotify te redirigirá a https://tudominio.com/callback
6. Verás la página de confirmación con los comandos disponibles

La persona que vincule su cuenta debe tener Spotify Premium. Las acciones se ejecutan sobre su sesión, así que si tiene Spotify Free, no podrá reproducir canciones a demanda ni saltar pistas.

Note

Asegúrate de que tienes Spotify reproduciéndose en algún dispositivo (ordenador, móvil, altavoz). Jaleo es un control remoto, no reproduce audio por sí mismo.

Paso 5: Probar los comandos

Ahora que el grupo está vinculado, prueba estos comandos en el grupo:

Mensaje	Acción
”pon Bad Bunny”	Reproduce la canción más popular de Bad Bunny
”pon Rosalia saoko”	Reproduce SAOKO de Rosalia
”siguiente”	Salta a la siguiente canción
”pausa”	Pausa la reproducción
”reanuda”	Reanuda la reproducción
”que está sonando”	Te dice qué canción está sonando
”volumen 50”	Pone el volumen al 50%
“añade a la cola Daddy Yankee”	Añade una canción a la cola sin interrumpir la actual

El bot entiende lenguaje natural, así que no hace falta que uses los comandos exactos. Puedes escribir “pon algo de reggaeton” o “sube el volumen” o “cambia esta canción” y el bot lo interpretará.

Paso 6: Verificar los logs

Si algo no funciona, revisa los logs:

# Logs de jaleo-api
pm2 logs jaleo-api --lines 50

# Logs de OpenClaw
pm2 logs openclaw --lines 50

Los logs de jaleo-api muestran cada petición al webhook:

[WEBHOOK] action=play, query=Rosalia, groupId=120363...@g.us
[TOKEN] Valid for 120363...@g.us
[WEBHOOK] 🎵 Reproduciendo: SAOKO

Los logs de OpenClaw muestran cómo interpreta los mensajes y llama al webhook.

Solución de problemas

El bot no responde

• Verifica que OpenClaw está corriendo: pm2 status
• Revisa los logs: pm2 logs openclaw --lines 50
• Asegúrate de que el número del bot está añadido al grupo

La vinculación de Spotify falla

• Verifica que la REDIRECT_URI en .env coincide exactamente con la que pusiste en el Spotify Developer Dashboard
• Verifica que el Client ID y Client Secret son correctos
• Asegúrate de que Caddy está funcionando y HTTPS es válido
• Revisa los logs de jaleo-api: pm2 logs jaleo-api --lines 50

Las canciones no se reproducen

• Asegúrate de que tienes Spotify reproduciéndose en algún dispositivo
• Jaleo no reproduce audio por sí mismo - es un control remoto
• Verifica que la cuenta vinculada tiene Spotify Premium

El bot no interpreta bien los mensajes

• Revisa que SOUL.md y SKILL.md tienen las URLs correctas (tu dominio real)
• Verifica que el modelo de IA está configurado correctamente en OpenClaw
• Reinicia OpenClaw: pm2 restart openclaw

Estructura final

Si todo funciona, deberías tener esto corriendo en tu VPS:

Proceso	Puerto	Función
jaleo-api	8888	API de Spotify (Express + SQLite)
openclaw	18789	Bot de WhatsApp + agente de IA
caddy	80/443	Reverse proxy + HTTPS

Y estos archivos de configuración:

Archivo	Dónde	Función
.env	/root/jaleo-api/	Variables de entorno de la API
Caddyfile	/etc/caddy/	Configuración del reverse proxy
SOUL.md	~/.openclaw/workspace/	Personalidad del bot
AGENTS.md	~/.openclaw/workspace/	Restricciones del agente
IDENTITY.md	~/.openclaw/workspace/	Nombre y emoji del bot
TOOLS.md	~/.openclaw/workspace/	Endpoints del webhook
openclaw.json	~/.openclaw/	Configuración general de OpenClaw

Enhorabuena! Jaleo está funcionando. Disfruta controlando Spotify desde WhatsApp.