6. Instalar OpenClaw

OpenClaw es el puente entre WhatsApp y el modelo de IA. Es quien recibe los mensajes, los interpreta y llama al webhook de jaleo-api.

Que es OpenClaw

OpenClaw es una plataforma de automatizacion que conecta WhatsApp con agentes de IA. Funciona asi:

1. Recibe mensajes de WhatsApp
2. Los procesa con un modelo de lenguaje (DeepSeek, Claude, GPT-4o, etc.)
3. Ejecuta acciones basadas en lo que el modelo decide (en este caso, llamar al webhook)
4. Responde en el grupo de WhatsApp

OpenClaw se configura mediante archivos de texto (Markdown) que definen la personalidad, las reglas y las herramientas del bot.

Paso 1: Instalar OpenClaw

Instala OpenClaw globalmente con npm:

npm install -g @anthropic/openclaw

Note

openClaw se instala como un paquete npm global. Asegurate de tener Node.js 20+ instalado (lo instalamos en el paso del VPS).

Verifica la instalacion:

openclaw --version

Paso 2: Configurar OpenClaw

Ejecuta el asistente de configuracion:

openclaw configure

El asistente te guiara por varias pantallas:

Canales

Habilita el canal de WhatsApp:

• Selecciona WhatsApp como canal habilitado

Gateway

Configura el gateway local:

• Modo: local
• Puerto: 18789 (por defecto)
• Auth: token (genera un token automatico o pon el tuyo)

Modelo de IA

Selecciona el modelo de lenguaje que usara el bot. Las opciones recomendadas:

| Proveedor | Modelo | Ventajas | |-----------|--------|----------| | DeepSeek V4 Flash | opencode-go/deepseek-v4-flash | Rapido, barato, buen espanol | | Claude | anthropic/claude-sonnet-4 | Mas preciso, mas caro | | GPT-4o | openai/gpt-4o | Buen equilibrio |

Tip

Recomendamos DeepSeek V4 Flash porque es economico, rapido y entiende perfectamente el espanol. Para un bot de musique en un grupo de amigos, no necesitas el modelo mas caro.

Para usar DeepSeek V4 Flash, necesitas una API key de OpenCode o de DeepSeek. El asistente te pedira la API key.

Perfil de autenticacion

El asistente te pedira que configures un perfil de autenticacion para el modelo de IA. Dependiendo del modelo que hayas elegido:

• DeepSeek via OpenCode: Necesitaras una API key de OpenCode. Te la proporcionan en opencode.ai al registrarte.
• DeepSeek directo: Necesitaras una API key de platform.deepseek.com.
• Claude: Necesitaras una API key de console.anthropic.com.
• GitHub Copilot: Si tienes acceso a GitHub Copilot, puedes usar su proveedor.

Paso 3: Vincular el numero de WhatsApp

Una vez configurado OpenClaw, vincula tu numero de WhatsApp:

openclaw pair

Esto generara un QR code en la terminal. Para vincularlo:

1. Abre WhatsApp en tu telefono (el telefono personal, el que ya usas)
2. Ve a Ajustes > Dispositivos vinculados
3. Toca “Vincular un dispositivo”
4. Escanea el QR code que aparece en la terminal del VPS

Si todo va bien, veras un mensaje de confirmacion en la terminal y el numero quedara vinculado.

Caution

El numero que vinculaste es el numero del bot. No uses tu numero personal. Debes usar el numero dedicado que compraste (por ejemplo, en JuicySMS).

El proceso de vinculacion funciona igual que cuando vinculas WhatsApp Web: el numero se anade como un dispositivo secundario de la cuenta de WhatsApp del numero que compraste.

Solucion de problemas

| Problema | Solucion | |----------|----------| | El QR code no aparece | Asegurate de que la terminal soporta caracteres Unicode. Usa una terminal moderna (iTerm2, Windows Terminal, etc.) | | El escaneo falla | El numero puede que ya tenga una sesion activa. Abre WhatsApp en el telefono con ese numero, borra la sesion y vuelve a intentar | | Se desconecta | Verifica que el VPS tenga conexion a internet estable. OpenClaw se reconecta automaticamente si la conexion se pierde brevemente |

Paso 4: Verificar que OpenClaw esta funcionando

Arranca OpenClaw en modo foreground para verificar:

openclaw serve

Deberias ver algo como:

OpenClaw v2026.5.26
WhatsApp channel: connected
Gateway: listening on port 18789
Agent: deepseek-v4-flash (opencode-go)

Si ves “WhatsApp channel: connected”, enhorabuena — OpenClaw esta recibiendo mensajes de WhatsApp.

Puedes probar enviando un mensaje al numero del bot desde tu telefono personal. El bot deberia responder (aun no sabra controla Spotify, pero deberia responder con algo).

Para parar OpenClaw, pulsa Ctrl+C.

Paso 5: Ejecutar OpenClaw en segundo plano (con PM2)

OpenClaw necesita estar corriendo permanentemente. Lo ejecutamos con PM2:

pm2 start "openclaw serve" --name openclaw
pm2 save

Verifica que esta corriendo:

pm2 status

Deberias ver dos procesos:

| Nombre | Estado | |--------|--------| | jaleo-api | online | | openclaw | online |

Comandos utiles

pm2 logs openclaw    # Ver logs en tiempo real
pm2 restart openclaw # Reiniciar OpenClaw
pm2 stop openclaw    # Parar OpenClaw

Note

En este punto, OpenClaw esta corriendo y conectado a WhatsApp, pero aun no sabe que es un DJ de Spotify. Esa personalidad se la daremos en el siguiente paso configurando el workspace.

Siguiente: Configurar el workspace