OpenWA + Claude — tu propio servidor de WhatsApp corriendo en tu compu con Claude contestando solo

Instalá OpenWA (github.com/rmyndharis/OpenWA) en mi compu paso a paso. Hacé esto:

1. Detectá mi OS · si es mac corré sw_vers · si es linux corré uname -a · si es windows corré ver.

2. Verificá si tengo Docker (docker --version) · si no lo tengo, decime el comando para instalarlo en mi OS y esperá que confirme.

3. Verificá que Docker Desktop esté corriendo (docker ps no debe dar error).

4. git clone https://github.com/rmyndharis/OpenWA.git en esta carpeta.

5. cd OpenWA && docker compose -f docker-compose.dev.yml up -d.

6. Esperá 2-3 minutos · mostrame los logs del pull mientras baja.

7. Verificá que localhost:2785 responde con curl · si responde, decime "abrí localhost:2785 en tu navegador" · si no, mostrame el error.

Pidiéndome confirmación antes de cada paso destructivo. En español Latam con voseo.

OpenWA está corriendo en localhost:2785. Conectame mi número así · armá un script connect.js:

1. POST a /api/sessions con sessionId "mi-vendedor".

2. POST a /api/sessions/mi-vendedor/start.

3. GET a /api/sessions/mi-vendedor/qr pollearlo cada 2 segundos hasta tener el base64.

4. Usá qrcode-terminal (npm install qrcode-terminal) para dibujar el QR en mi terminal en ASCII grande.

5. Pollear /api/sessions/mi-vendedor/status cada 3 segundos hasta que diga connected · cuando confirme, decí "número conectado, listo para el bridge" y terminá.

6. Agregá package.json con las dependencies · mostrame el comando exacto para correrlo.

Si algo falla, mostrame el error completo · no asumas.

Armá bridge.js que conecte OpenWA (localhost:2785) con la API de Claude para responder mensajes de WhatsApp automáticamente. Variables:

- NOMBRE-NEGOCIO: [poné el nombre]
- QUE-VENDÉS: [una línea]
- TONO: [ej: cálido voseo Latam mensajes cortos]

Requisitos:
1. Express en localhost:3001 · endpoint POST /webhook.
2. Verificá HMAC con OPENWA_WEBHOOK_SECRET · 401 si no coincide.
3. Extraé text, sessionId, chatId del payload de OpenWA.
4. Llamá @anthropic-ai/sdk · modelo claude-haiku-4-5-20251001 · max_tokens 500. System prompt con la personalidad de las variables de arriba + 4 reglas (no inventes precios · pasá a humano si la pregunta es compleja · mensajes de máximo 3 líneas · sin saludos largos).
5. POST la respuesta de Claude a /api/sessions/{sessionId}/messages/send-text con header X-API-Key (OPENWA_API_KEY del env).
6. Logging estructurado [webhook] [claude] [openwa] [error].
7. Retry exponencial 3 intentos (500ms · 1500ms · 4000ms) para 5xx · fallback "estamos con un problema técnico" si todos fallan.
8. .env.example con todas las vars · .gitignore con .env.
9. package.json con dev (node --watch) y start.
10. README.md de 10 líneas de uso.

Después mostrame el comando para configurar el webhook de OpenWA apuntando a http://localhost:3001/webhook con el HMAC secret.

Reemplazá el system prompt actual del bridge.js con este · adaptado a mi caso. Variables:

- NOMBRE-NEGOCIO: [ej: Cafetería Don Luis]
- QUÉ-VENDÉS: [ej: café especial, pastelería casera, almuerzos para llevar]
- TONO: [ej: amable, cálido, voseo Latam, mensajes cortos, sin emojis]
- QUÉ-NO-HACER: [ej: no inventes precios · no prometas tiempos de entrega · no des recetas]
- CUÁNDO-DERIVAR-A-HUMANO: [ej: si preguntan por catering, reservas de grupo, quejas]

System prompt final (pegámelo verbatim en bridge.js como const SYSTEM_PROMPT):

"Sos el asistente de WhatsApp de [NOMBRE-NEGOCIO]. Vendemos [QUÉ-VENDÉS].

Tono: [TONO].

Reglas:
1. Si te preguntan algo que no sabés, decí: 'dejame consultar y te confirmo, dame unos minutos'.
2. Si piden precios y no los tenés en este prompt, decí: 'te paso el catálogo por acá ahora mismo' (pero NO inventes precios).
3. [QUÉ-NO-HACER].
4. Si la pregunta entra en estos casos: [CUÁNDO-DERIVAR-A-HUMANO] · respondé: 'te paso con [TU-NOMBRE], él te contesta en breve'.
5. Mensajes cortos, máximo 3 líneas. Sin saludos largos."

Reiniciá el bridge (Ctrl+C y npm run dev de nuevo) y confirmame que el system prompt nuevo está cargado.

OpenWA y bridge.js están corriendo. Quiero probar el flow completo. Ayudame así:

1. Decime cómo verificar que OpenWA y el bridge están vivos · qué comando correr para chequear (curl localhost:2785, ps aux | grep node, etc).

2. Dame instrucciones claras para mandar un mensaje al número conectado · "abrí WhatsApp en otro teléfono, escribíle al número [TU-NUMERO], pegá este texto: 'Hola, ¿cuánto cuesta el café?'" · ese texto debe ser representativo del caso real.

3. Mientras yo mando el mensaje, monitoreá los logs del bridge en la terminal · decime exactamente qué tengo que ver aparecer: [webhook] mensaje recibido, [claude] generando respuesta, [openwa] enviando respuesta.

4. Cuando llegue la respuesta de vuelta a mi WhatsApp, pedime que te la pegue · revisá si el tono coincide con el system prompt · si está raro, decime qué ajustar.

5. Si algo no anduvo (el mensaje no llegó, el bridge no logueó nada, etc), guíame paso a paso para debuggear · empezando por verificar que el webhook de OpenWA está configurado correctamente apuntando a localhost:3001/webhook.

Mi bridge contestó esto y no me convence:

[Pegá el chat: lo que escribió el cliente · lo que respondió Claude · qué hubiera contestado vos]

Ayudame a iterar:

1. Diagnosticá por qué Claude respondió así · ¿es el system prompt? ¿es el modelo? ¿es que faltaba contexto en la conversación?

2. Si es el system prompt, proponé 2 versiones del fix · una mínima (1 regla nueva) y una más profunda (rewrite de la sección de tono o reglas). Mostrame ambas, dejame elegir.

3. Si es el modelo (Haiku no captura matices), proponé subir a Sonnet · explicame el costo extra (~10x más por respuesta).

4. Si es contexto, proponé agregar memoria de últimos 5 mensajes por chatId · explicame los pros y contras (Claude entiende mejor pero gasta más tokens).

5. Después de elegir, aplicá el cambio al bridge.js o .env · reiniciá · pedime que pruebe de nuevo con el mismo mensaje original para comparar.

Quiero agregar 6 reglas anti-baneo a mi setup de OpenWA para que WhatsApp no me banee el número. Tengo bridge.js funcionando en esta carpeta. Hacé estos cambios sin romper lo que ya hay.

PARTE 1 · sumá estas 4 reglas al SYSTEM_PROMPT (ya sea constante en bridge.js o env SYSTEM_PROMPT)

Encontrá el SYSTEM_PROMPT actual · agregá estas 4 reglas a continuación de las que ya están (sin borrar las existentes · solo sumalas como reglas 5, 6, 7, 8):

5) Variá saludos, cierres y formulaciones · nunca uses la misma apertura más de 2 veces seguidas · alterná entre "Hola", "¡Buenas!", "Holaa", "Hola, ¿qué necesitás?", etc. Mismo con los cierres · variación natural simula humano.

6) Si el usuario escribe "stop", "borrame", "no me escribas más", "alta", "quitame", o expresa enojo sobre recibir mensajes ("¿quién te dio mi número?", "dejá de joder"), respondé UNA última vez disculpándote brevemente y después marcá ese chatId como BLOQUEADO en memoria · no respondas más a ese chat hasta que el usuario escriba algo positivo (saludo, pregunta neutral).

7) Espejá el tono, idioma y longitud del usuario · si te escribe formal, respondé formal · si escribe en spanglish, respondé en spanglish · si te manda 3 palabras, respondé en 3 palabras · no le tires un párrafo a una pregunta corta.

8) No mandes el mismo template verbatim a varios chats · si la misma pregunta llega de chats distintos, contestala con redacciones distintas (misma información, distintas palabras).

PARTE 2 · agregá estos 3 mecanismos al bridge.js

a) DELAY ARTIFICIAL · justo antes del POST a /api/sessions/{sessionId}/messages/send-text, esperá un random entre 5000-15000 ms · usá Math.floor(Math.random() * 10000 + 5000) · si el texto de la respuesta es largo (>200 chars), sumá 1000ms cada 100 chars adicionales (simulando que tardás más tipeando textos largos). Loggealo como [delay] esperando Xs antes de responder.

b) PAUSA NOCTURNA · al inicio del manejo de cada webhook, checkeá la hora local con new Date() y un offset de TZ del env (default America/Argentina/Buenos_Aires). Si la hora actual está entre NIGHT_PAUSE_START (default 22) y NIGHT_PAUSE_END (default 8), NO mandes la respuesta inmediatamente · poné el mensaje en una cola en memoria (array simple { chatId, sessionId, originalText, claudeResponse, queuedAt }) y arrancá un setInterval que cada 15 minutos checkea si ya son las NIGHT_PAUSE_END y procesa la cola en orden. Loggealo como [night-pause] mensaje encolado · responderá a las HH:MM.

c) RATE LIMIT POR CHAT · mantené un Map<chatId, lastReplyTimestamp> en memoria. Antes de mandar una respuesta, checkeá si el último envío al mismo chatId fue hace menos de 30 segundos · si sí, agregá ese delta al delay artificial (parte 2a) para que el bridge nunca dispare 2 mensajes al mismo chat en menos de 30s. Loggealo como [rate-limit] esperando Xs extra antes de responder a chatId.

PARTE 3 · entrega esperada

- Mostrame el diff antes de aplicar · sección por sección · explicame qué cambia y qué quedó intacto.
- Si alguna regla colide con algo del bridge actual (ej: ya hay un delay, ya hay un rate limit), pará y avisame · no sobrescribas sin preguntar.
- Después de aplicar, mostrame el comando para reiniciar (Ctrl+C + npm run dev) y proponé un test sencillo (mandate un mensaje, ver el log mostrando [delay] esperando Xs, ver la respuesta llegar 5-15s después).
- Si el .env necesita nuevas variables (TZ, NIGHT_PAUSE_START, NIGHT_PAUSE_END), updateá .env.example con comentarios pero NO toques mi .env existente.

Importante: la regla #07 (warmup gradual del número · día 1 max 10 chats, día 2 max 20, etc.) es operativa · no la implementes en código, solo recordámela en el README.md con un párrafo claro.