Mensajes Grupales

Comportamiento y configuración de manejo de mensajes grupales de WhatsApp. mentionPatterns se comparten entre todas las interfaces (CLI, TUI, Web UI).

Esta página se enfoca en el comportamiento de manejo de mensajes grupales específico de WhatsApp, incluyendo modos de activación, inyección de contexto de historial, y gateo de menciones.

Los grupos de WhatsApp soportan dos modos de activación:

- ''mention'' (predeterminado): Solo activar respuestas cuando se @menciona o cuando coincide con mentionPatterns.

- ''always'' (siempre): Activar respuestas para todos los mensajes grupales (no recomendado para grupos públicos).

Configuración:

- Global: ''channels.whatsapp.groupPolicy = mention|always''

- Por grupo: ''channels.whatsapp.groups.<jid>.requireMention = false'' (establece en false para modo always)

mentionPatterns es un array de expresiones regulares usadas para coincidir texto en mensajes grupales, activando respuestas incluso sin @menciones.

{ "messages": { "groupChat": { "mentionPatterns": [ "^(?i)\\b(bot|asistente|ayuda|ai)\\b", "^@openclaw", "^(?i)\\b(oye|hola|hi)\\s+openclaw" ] } } }

También puede ser sobrescrito por agente:

''agents.list[].groupChat.mentionPatterns''

Cuando los mensajes grupales no activan una respuesta (sin mención / bloqueado por lista permitida), OpenClaw almacena estos mensajes como pendientes.

En el próximo disparo, estos mensajes pendientes se inyectan en el prompt como contexto para ayudar al modelo a entender el historial de conversación.

Esto asegura que incluso si el bot no responde a cada mensaje, todavía puede mantenerse al día con las últimas discusiones en el grupo.

Cuando un mensaje grupal activa una respuesta, OpenClaw inyecta mensajes de historial reciente en el prompt.

Los mensajes de historial se dividen en dos partes:

- Mensajes pendientes: Mensajes desde la última respuesta que no fueron procesados (hasta historyLimit).

- Mensajes de transcripción: Mensajes históricos que han sido escritos en el registro de sesión.

Principales opciones de configuración para manejo de mensajes grupales de WhatsApp:

- ''channels.whatsapp.groupPolicy'': Modo de activación global (mention/always).

- ''channels.whatsapp.groups.<jid>.requireMention'': Sobrescribir modo de activación por grupo.

- ''channels.whatsapp.historyLimit'': Número máximo de mensajes de historial pendientes (predeterminado 50).

Algunos canales soportan el comando ''/activation'' (afecta solo la sesión actual):

- ''/activation mention'': Requiere mención (predeterminado).

- ''/activation always'': Responder a todos los mensajes.

Nota: Este comando típicamente solo funciona para remitentes autorizados (owner/lista permitida). Para persistir comportamiento, escribe configuración en lugar de depender de comandos de sesión.