> ## Documentation Index > Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt > Use this file to discover all available pages before exploring further. # Mensajes de grupo # Mensajes de grupo (canal web de WhatsApp) Objetivo: permitir que Clawd esté en grupos de WhatsApp, se active solo cuando lo mencionen y mantenga ese hilo separado de la sesión personal de mensajes directos. Nota: `agents.list[].groupChat.mentionPatterns` ahora también se usa en Telegram/Discord/Slack/iMessage; este documento se centra en el comportamiento específico de WhatsApp. Para configuraciones con múltiples agentes, configure `agents.list[].groupChat.mentionPatterns` por agente (o use `messages.groupChat.mentionPatterns` como respaldo global). ## Qué está implementado (2025-12-03) * Modos de activación: `mention` (predeterminado) o `always`. `mention` requiere un ping (menciones reales de WhatsApp con @ mediante `mentionedJids`, patrones regex o el E.164 del bot en cualquier parte del texto). `always` activa al agente con cada mensaje, pero solo debería responder cuando pueda aportar valor significativo; de lo contrario devuelve el token silencioso `NO_REPLY`. Los valores predeterminados se pueden establecer en la configuración (`channels.whatsapp.groups`) y sobrescribir por grupo mediante `/activation`. Cuando se establece `channels.whatsapp.groups`, también actúa como una lista de permitidos de grupos (incluya `"*"` para permitir todos). * Política de grupo: `channels.whatsapp.groupPolicy` controla si se aceptan mensajes de grupo (`open|disabled|allowlist`). `allowlist` usa `channels.whatsapp.groupAllowFrom` (respaldo: `channels.whatsapp.allowFrom` explícito). El valor predeterminado es `allowlist` (bloqueado hasta que agregue remitentes). * Sesiones por grupo: las claves de sesión tienen el formato `agent::whatsapp:group:`, por lo que comandos como `/verbose on` o `/think high` (enviados como mensajes independientes) quedan delimitados a ese grupo; el estado de los mensajes directos personales no se ve afectado. Los heartbeats se omiten para los hilos de grupo. * Inyección de contexto: los mensajes de grupo **solo pendientes** (50 por defecto) que *no* activaron una ejecución se anteponen bajo `[Chat messages since your last reply - for context]`, con la línea que activó bajo `[Current message - respond to this]`. Los mensajes que ya están en la sesión no se reinyectan. * Exposición del remitente: cada lote de grupo ahora termina con `[from: Sender Name (+E164)]` para que Pi sepa quién está hablando. * Efímeros/ver-una-vez: los descomprimimos antes de extraer texto/menciones, por lo que los pings dentro de ellos aún activan. * Prompt del sistema para grupos: en el primer turno de una sesión de grupo (y siempre que `/activation` cambie el modo) inyectamos un breve texto en el prompt del sistema como `You are replying inside the WhatsApp group "". Group members: Alice (+44...), Bob (+43...), … Activation: trigger-only … Address the specific sender noted in the message context.`. Si no hay metadatos disponibles, igualmente informamos al agente que es un chat grupal. ## Ejemplo de configuración (WhatsApp) Agregue un bloque `groupChat` a `~/.openclaw/openclaw.json` para que los pings por nombre visible funcionen incluso cuando WhatsApp elimina el `@` visual en el cuerpo del texto: ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { channels: { whatsapp: { groups: { "*": { requireMention: true }, }, }, }, agents: { list: [ { id: "main", groupChat: { historyLimit: 50, mentionPatterns: ["@?openclaw", "\\+?15555550123"], }, }, ], }, } ``` Notas: * Las regex no distinguen mayúsculas/minúsculas; cubren un ping por nombre visible como `@openclaw` y el número sin procesar con o sin `+`/espacios. * WhatsApp aún envía menciones canónicas mediante `mentionedJids` cuando alguien toca el contacto, por lo que el respaldo por número rara vez es necesario, pero es una red de seguridad útil. ### Comando de activación (solo propietario) Use el comando del chat de grupo: * `/activation mention` * `/activation always` Solo el número del propietario (de `channels.whatsapp.allowFrom`, o el E.164 del propio bot cuando no está configurado) puede cambiar esto. Envíe `/status` como un mensaje independiente en el grupo para ver el modo de activación actual. ## Cómo usar 1. Agregue su cuenta de WhatsApp (la que ejecuta OpenClaw) al grupo. 2. Diga `@openclaw …` (o incluya el número). Solo los remitentes en la lista de permitidos pueden activarlo, a menos que configure `groupPolicy: "open"`. 3. El prompt del agente incluirá el contexto reciente del grupo más el marcador final `[from: …]` para que pueda dirigirse a la persona correcta. 4. Las directivas a nivel de sesión (`/verbose on`, `/think high`, `/new` o `/reset`, `/compact`) se aplican solo a la sesión de ese grupo; envíelas como mensajes independientes para que se registren. Su sesión personal de mensajes directos permanece independiente. ## Pruebas / verificación * Humo manual: * Envíe un ping `@openclaw` en el grupo y confirme una respuesta que haga referencia al nombre del remitente. * Envíe un segundo ping y verifique que el bloque de historial esté incluido y luego se borre en el siguiente turno. * Revise los registros del Gateway (ejecute con `--verbose`) para ver entradas `inbound web message` que muestren `from: ` y el sufijo `[from: …]`. ## Consideraciones conocidas * Los heartbeats se omiten intencionalmente para grupos para evitar transmisiones ruidosas. * La supresión de eco usa la cadena combinada del lote; si envía texto idéntico dos veces sin menciones, solo la primera obtendrá respuesta. * Las entradas del almacén de sesiones aparecerán como `agent::whatsapp:group:` en el almacén de sesiones (`~/.openclaw/agents//sessions/sessions.json` de forma predeterminada); una entrada faltante solo significa que el grupo aún no ha activado una ejecución. * Los indicadores de escritura en grupos siguen `agents.defaults.typingMode` (predeterminado: `message` cuando no hay mención).