브로드캐스트 그룹

개요

브로드캐스트 그룹은 동일한 수신 메시지에 대해 여러 에이전트를 실행합니다. 각 에이전트는 자체적으로 격리된 세션에서 메시지를 처리하고 개별 응답을 게시하므로, 하나의 WhatsApp 번호로 단일 그룹 채팅이나 DM에서 전문 에이전트 팀을 운영할 수 있습니다.

브로드캐스트 그룹은 채널 허용 목록 및 그룹 활성화 규칙을 적용한 후 평가됩니다. WhatsApp 그룹에서는 OpenClaw가 일반적으로 응답하는 조건일 때 브로드캐스트가 실행됩니다(예: 그룹 설정에 따라 멘션되었을 때). 브로드캐스트는 어떤 에이전트가 실행되는지만 변경하며, 메시지가 처리 대상인지 여부는 변경하지 않습니다.

실제 WhatsApp QA 레인에는 whatsapp-broadcast-group-fanout이 포함되어 있으며, 멘션이 포함된 그룹 메시지 하나가 구성된 두 에이전트로부터 서로 구분되는 응답을 표시할 수 있는지 검증합니다.

구성

기본 설정

최상위 수준에 broadcast 섹션을 추가합니다(bindings 옆). 키는 WhatsApp 피어 ID이고 값은 에이전트 ID 배열입니다.

• 그룹 채팅: 그룹 JID(예: 120363403215116621@g.us)
• DM: 발신자의 E.164 전화번호(예: +15551234567)

{  "broadcast": {    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]  }}

결과: OpenClaw가 이 채팅에 응답하는 조건일 때 세 에이전트를 모두 실행합니다.

나열된 모든 에이전트 ID는 agents.list에 존재해야 합니다. 구성 검증 시 알 수 없는 ID가 보고되며, 런타임은 Broadcast agent <id> not found in agents.list; skipping 경고를 남기고 해당 에이전트를 건너뜁니다.

처리 전략

broadcast.strategy는 에이전트가 메시지를 처리하는 방식을 설정합니다.

{  "broadcast": {    "strategy": "sequential",    "120363403215116621@g.us": ["alfred", "baerbel"]  }}

전체 예시

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

작동 방식

메시지 흐름

세션 격리

브로드캐스트 그룹의 각 에이전트는 다음 항목을 완전히 별도로 유지합니다.

• 세션 키(agent:alfred:whatsapp:group:120363...와 agent:baerbel:whatsapp:group:120363...)
• 대화 기록(에이전트는 다른 에이전트의 응답을 볼 수 없음)
• 작업 공간(구성된 경우 별도의 샌드박스)
• 도구 접근 권한(서로 다른 허용/거부 목록)
• 메모리/컨텍스트(별도의 IDENTITY.md, SOUL.md 등)

의도적으로 공유하는 한 가지 예외가 있습니다. 그룹 컨텍스트 버퍼(컨텍스트로 사용하는 최근 그룹 메시지)는 피어별로 공유되므로, 모든 브로드캐스트 에이전트가 트리거될 때 동일한 컨텍스트를 확인합니다. 팬아웃이 완료된 후 한 번 지워집니다.

따라서 각 에이전트에 서로 다른 성격, 모델, Skills 및 도구 접근 권한(예: 읽기 전용과 읽기-쓰기)을 부여할 수 있습니다.

예시: 격리된 세션

에이전트가 ["alfred", "baerbel"]인 그룹 120363403215116621@g.us의 경우:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: ~/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: ~/openclaw-baerbel/Tools: read only

사용 사례

• 전문 에이전트 팀: code-reviewer, security-auditor, test-generator, docs-checker가 각자의 관점에서 동일한 메시지에 답변하는 개발 그룹입니다.
• 다국어 지원: 하나의 지원 채팅에서 support-en, support-de, support-es가 각자의 언어로 응답합니다.
• 품질 보증: support-agent가 답변하는 동안 qa-agent가 검토하고 문제를 발견한 경우에만 응답합니다.
• 작업 자동화: task-tracker, time-logger, report-generator가 모두 동일한 상태 업데이트를 처리합니다.

권장 사항

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

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

호환성

제공자

브로드캐스트 그룹은 현재 WhatsApp(웹 채널)에서만 구현되어 있습니다. 다른 채널은 broadcast 구성을 무시합니다.

라우팅

브로드캐스트 그룹은 기존 라우팅과 함께 작동합니다.

{  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}

• GROUP_A: alfred만 응답합니다(일반 라우팅).
• GROUP_B: agent1과 agent2가 모두 응답합니다(브로드캐스트).

문제 해결

openclaw logs --follow | grep -i broadcast

예시

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

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

API 참조

구성 스키마

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

필드

제한 사항

1. 최대 에이전트 수: 엄격한 제한은 없지만 에이전트가 많으면(10개 이상) 느려질 수 있습니다.
2. 공유 컨텍스트: 에이전트는 서로의 응답을 볼 수 없습니다(의도된 동작).
3. 메시지 순서: 병렬 응답은 순서와 관계없이 도착할 수 있습니다.
4. 사용량 제한: 모든 응답이 하나의 WhatsApp 계정에서 전송되므로, 모든 에이전트의 응답이 동일한 WhatsApp 사용량 제한에 포함됩니다.

관련 항목

• 채널 라우팅
• 그룹
• 멀티 에이전트 샌드박스 도구
• 페어링
• 세션 관리