Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Estado: Experimental. Añadido en 2026.1.9.

​
Descripción general

Los grupos de difusión permiten que varios agentes procesen y respondan al mismo mensaje simultáneamente. Esto te permite crear equipos de agentes especializados que trabajan juntos en un único grupo o DM de WhatsApp, todo usando un solo número de teléfono. Alcance actual: solo WhatsApp (canal web). Los grupos de difusión se evalúan después de las listas de permitidos del canal y las reglas de activación de grupos. En los grupos de WhatsApp, esto significa que las difusiones ocurren cuando OpenClaw normalmente respondería (por ejemplo: al mencionarlo, según la configuración de tu grupo).

​
Casos de uso

Implementa varios agentes con responsabilidades atómicas y enfocadas:
Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)
Cada agente procesa el mismo mensaje y aporta su perspectiva especializada.
Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

Group: "Customer Support"
Agents:
  - SupportAgent (provides answer)
  - QAAgent (reviews quality, only responds if issues found)

Group: "Project Management"
Agents:
  - TaskTracker (updates task database)
  - TimeLogger (logs time spent)
  - ReportGenerator (creates summaries)

​
Configuración

​
Configuración básica

Añade una sección broadcast de nivel superior (junto a bindings). Las claves son ids de pares de WhatsApp:
  • chats grupales: JID del grupo (p. ej., 120363403215116621@g.us)
  • DM: número de teléfono E.164 (p. ej., +15551234567)
{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}
Resultado: Cuando OpenClaw respondería en este chat, ejecutará los tres agentes.

​
Estrategia de procesamiento

Controla cómo los agentes procesan los mensajes:
Todos los agentes procesan simultáneamente:
{
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"]
  }
}

​
Ejemplo completo

{
  "agents": {
    "list": [
      {
        "id": "code-reviewer",
        "name": "Code Reviewer",
        "workspace": "/path/to/code-reviewer",
        "sandbox": { "mode": "all" }
      },
      {
        "id": "security-auditor",
        "name": "Security Auditor",
        "workspace": "/path/to/security-auditor",
        "sandbox": { "mode": "all" }
      },
      {
        "id": "docs-generator",
        "name": "Documentation Generator",
        "workspace": "/path/to/docs-generator",
        "sandbox": { "mode": "all" }
      }
    ]
  },
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"],
    "120363424282127706@g.us": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

​
Cómo funciona

​
Flujo de mensajes

1

Llega un mensaje entrante

Llega un mensaje de un grupo o DM de WhatsApp.
2

Comprobación de difusión

El sistema comprueba si el ID de par está en broadcast.
3

Si está en la lista de difusión

  • Todos los agentes listados procesan el mensaje.
  • Cada agente tiene su propia clave de sesión y contexto aislado.
  • Los agentes procesan en paralelo (predeterminado) o secuencialmente.
4

Si no está en la lista de difusión

Se aplica el enrutamiento normal (primer binding coincidente).
Los grupos de difusión no omiten las listas de permitidos del canal ni las reglas de activación de grupos (menciones/comandos/etc.). Solo cambian qué agentes se ejecutan cuando un mensaje es apto para procesamiento.

​
Aislamiento de sesiones

Cada agente en un grupo de difusión mantiene completamente separados:
  • Claves de sesión (agent:alfred:whatsapp:group:120363... frente a agent:baerbel:whatsapp:group:120363...)
  • Historial de conversación (el agente no ve los mensajes de otros agentes)
  • Workspace (sandboxes separados si están configurados)
  • Acceso a herramientas (listas de permitir/denegar diferentes)
  • Memoria/contexto (IDENTITY.md, SOUL.md, etc. separados)
  • Búfer de contexto del grupo (mensajes recientes del grupo usados como contexto) se comparte por par, por lo que todos los agentes de difusión ven el mismo contexto cuando se activan
Esto permite que cada agente tenga:
  • Personalidades diferentes
  • Acceso a herramientas diferente (p. ej., solo lectura frente a lectura y escritura)
  • Modelos diferentes (p. ej., opus frente a sonnet)
  • Skills diferentes instaladas

​
Ejemplo: sesiones aisladas

En el grupo 120363403215116621@g.us con los agentes ["alfred", "baerbel"]: 
Session: agent:alfred:whatsapp:group:120363403215116621@g.us
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

​
Mejores prácticas

Diseña cada agente con una responsabilidad única y clara:
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ Bueno: Cada agente tiene una tarea. ❌ Malo: Un agente genérico “dev-helper”.
Deja claro qué hace cada agente:
{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}
Da a los agentes solo las herramientas que necesitan:
{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}
reviewer es de solo lectura. fixer puede leer y escribir.
Con muchos agentes, considera:
  • Usar "strategy": "parallel" (predeterminado) para mayor velocidad
  • Limitar los grupos de difusión a 5-10 agentes
  • Usar modelos más rápidos para agentes más simples
Los agentes fallan de forma independiente. El error de un agente no bloquea a los demás:
Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

​
Compatibilidad

​
Proveedores

Actualmente, los grupos de difusión funcionan con:
  • ✅ WhatsApp (implementado)
  • 🚧 Telegram (planificado)
  • 🚧 Discord (planificado)
  • 🚧 Slack (planificado)

​
Enrutamiento

Los grupos de difusión funcionan junto con el enrutamiento existente: 
{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}
  • GROUP_A: Solo responde alfred (enrutamiento normal).
  • GROUP_B: agent1 Y agent2 responden (difusión).
Precedencia: broadcast tiene prioridad sobre bindings.

​
Solución de problemas

Comprueba:
  1. Los IDs de agentes existen en agents.list.
  2. El formato del ID de par es correcto (p. ej., 120363403215116621@g.us).
  3. Los agentes no están en listas de denegación.
Depuración:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
Causa: Es posible que el ID de par esté en bindings, pero no en broadcast.Solución: Añádelo a la configuración de difusión o elimínalo de los bindings.
Si va lento con muchos agentes:
  • Reduce el número de agentes por grupo.
  • Usa modelos más ligeros (sonnet en lugar de opus).
  • Comprueba el tiempo de inicio del sandbox.

​
Ejemplos

{
  "broadcast": {
    "strategy": "parallel",
    "120363403215116621@g.us": [
      "code-formatter",
      "security-scanner",
      "test-coverage",
      "docs-checker"
    ]
  },
  "agents": {
    "list": [
      {
        "id": "code-formatter",
        "workspace": "~/agents/formatter",
        "tools": { "allow": ["read", "write"] }
      },
      {
        "id": "security-scanner",
        "workspace": "~/agents/security",
        "tools": { "allow": ["read", "exec"] }
      },
      {
        "id": "test-coverage",
        "workspace": "~/agents/testing",
        "tools": { "allow": ["read", "exec"] }
      },
      { "id": "docs-checker", "workspace": "~/agents/docs", "tools": { "allow": ["read"] } }
    ]
  }
}
El usuario envía: Fragmento de código.Respuestas:
  • code-formatter: “Fixed indentation and added type hints”
  • security-scanner: “⚠️ SQL injection vulnerability in line 12”
  • test-coverage: “Coverage is 45%, missing tests for error cases”
  • docs-checker: “Missing docstring for function process_data”
{
  "broadcast": {
    "strategy": "sequential",
    "+15555550123": ["detect-language", "translator-en", "translator-de"]
  },
  "agents": {
    "list": [
      { "id": "detect-language", "workspace": "~/agents/lang-detect" },
      { "id": "translator-en", "workspace": "~/agents/translate-en" },
      { "id": "translator-de", "workspace": "~/agents/translate-de" }
    ]
  }
}

​
Referencia de API

​
Esquema de configuración

interface OpenClawConfig {
  broadcast?: {
    strategy?: "parallel" | "sequential";
    [peerId: string]: string[];
  };
}

​
Campos

​
strategy
"parallel" | "sequential"
predeterminado:"\"parallel\""
Cómo procesar los agentes. parallel ejecuta todos los agentes simultáneamente; sequential los ejecuta en orden de array.
​
[peerId]
string[]
JID de grupo de WhatsApp, número E.164 u otro ID de par. El valor es el array de IDs de agentes que deben procesar los mensajes.

​
Limitaciones

  1. Máximo de agentes: No hay un límite estricto, pero 10+ agentes pueden ser lentos.
  2. Contexto compartido: Los agentes no ven las respuestas de los demás (por diseño).
  3. Orden de mensajes: Las respuestas en paralelo pueden llegar en cualquier orden.
  4. Límites de tasa: Todos los agentes cuentan para los límites de tasa de WhatsApp.

​
Mejoras futuras

Funciones planificadas:
  • Modo de contexto compartido (los agentes ven las respuestas de los demás)
  • Coordinación de agentes (los agentes pueden enviarse señales entre sí)
  • Selección dinámica de agentes (elige agentes según el contenido del mensaje)
  • Prioridades de agentes (algunos agentes responden antes que otros)

​
Relacionado