Grupos de difusión

# 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

Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)

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., [email protected])
• DM: número de teléfono E.164 (p. ej., +15551234567)

{
  "broadcast": {
    "[email protected]": ["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:

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": ["alfred", "baerbel"]
  }
}

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

# Cómo funciona

# Flujo de mensajes

# 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 [email protected] con los agentes ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:[email protected]
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:[email protected]
History: [user message, baerbel's previous responses]
Workspace: /Users/user/openclaw-baerbel/
Tools: read only

# Mejores prácticas

{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}

{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}

{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] }
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] }
    }
  }
}

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).

# Solución de problemas

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

# Ejemplos

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": [
      "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"] } }
    ]
  }
}

{
  "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

# 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

• Enrutamiento de canales
• Grupos
• Herramientas de sandbox multiagente
• Emparejamiento
• Gestión de sesiones