8. Anadir el bot a un grupo

Ya tenemos todo configurado. Ahora vamos a probarlo.

Paso 1: Anadir el numero del bot a tus contactos

En tu telefono personal (no el del bot):

1. Abre la app de contactos
2. Crea un nuevo contacto con el numero 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. Anade el contacto de Jaleo como participante del grupo

El bot deberia aparecer en la lista de participantes del grupo.

Paso 3: Escribir el primer mensaje

Ecribe en el grupo:

pon musica

Como el grupo aun no esta vinculado a Spotify, el bot deberia responder con algo como:

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

Paso 4: Vincular Spotify

1. Toca el enlace que el bot envio
2. Se abrira el navegador y te redirigira a la pagina de autorizacion de Spotify
3. Inicia sesion con tu cuenta de Spotify Premium
4. Autoriza los permisos (reproduccion, lectura del estado, cancion actual)
5. Spotify te redirigira a https://tudominio.com/callback
6. Veras la pagina de confirmacion con los comandos disponibles

La persona que vincule su cuenta debe tener Spotify Premium. Las acciones se ejecutan sobre su sesion, asi que si tiene Spotify Free, no podra reproducir canciones a demanda ni saltar pistas.

Note

Asegurate de que tienes la app de Spotify abierta y reproduciendo en algun dispositivo (ordenador, movil, altavoz). Jaleo es un control remoto, no reproduce audio por si mismo.

Paso 5: Probar los comandos

Ahora que el grupo esta vinculado, prueba estos comandos en el grupo:

| Mensaje | Accion | |---------|--------| | “pon Bad Bunny” | Reproduce la cancion mas popular de Bad Bunny | | “pon Rosalia saoko” | Reproduce SAOKO de Rosalia | | “siguiente” | Salta a la siguiente cancion | | “pausa” | Pausa la reproduccion | | “reanuda” | Reanuda la reproduccion | | “que esta sonando” | Te dice que cancion esta sonando | | “volumen 50” | Pone el volumen al 50% | | “anade a la cola Daddy Yankee” | Anade una cancion a la cola sin interrumpir la actual |

El bot entiende lenguaje natural, asi que no hace falta que uses los comandos exactos. Puedes escribir “pon algo de reggaeton” o “sube el volumen” o “cambia esta cancion” y el bot lo interpretara.

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 peticion 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 como interpreta los mensajes y llama al webhook.

Solucion de problemas

El bot no responde

• Verifica que OpenClaw esta corriendo: pm2 status
• Revisa los logs: pm2 logs openclaw --lines 50
• Asegurate de que el numero del bot esta anadido al grupo

La vinculacion 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
• Asegurate de que Caddy esta funcionando y HTTPS es valido
• Revisa los logs de jaleo-api: pm2 logs jaleo-api --lines 50

Las canciones no se reproducen

• Asegurate de que tienes la app de Spotify abierta y reproduciendo en algun dispositivo
• Jaleo no reproduce audio por si 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 esta configurado correctamente en OpenClaw
• Reinicia OpenClaw: pm2 restart openclaw

Estructura final

Si todo funciona, deberias tener esto corriendo en tu VPS:

| Proceso | Puerto | Funcion | |---------|--------|---------| | 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 configuracion:

| Archivo | Donde | Funcion | |---------|-------|---------| | .env | /root/jaleo-api/ | Variables de entorno de la API | | Caddyfile | /etc/caddy/ | Configuracion 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/ | Configuracion general de OpenClaw |

Enhorabuena! Jaleo esta funcionando. Disfruta controlando Spotify desde WhatsApp.