Broadcast Groups: 여러 에이전트가 동시에 응답하게 만들기

에이전트 하나에게 너무 많은 역할을 맡기다 보면 프롬프트가 복잡해지고 관리가 어려워지곤 하죠. 코드 리뷰도 해야 하고, 보안 점검에 문서화까지 한꺼번에 처리하려다 보면 성능도 떨어지고 답변의 질도 낮아질 수 있습니다.

이럴 때 여러 전문 에이전트가 팀처럼 움직여서 각자의 관점으로 동시에 답변해 주면 훨씬 효율적입니다. OpenClaw의 Broadcast Groups 기능을 사용하면 WhatsApp 그룹이나 DM에서 하나의 메시지를 여러 에이전트가 한꺼번에 처리하도록 설정할 수 있습니다.

필요한 것

• OpenClaw 버전 2026.1.9 이상
• WhatsApp 계정 (Web channel 전용)
• agents.list에 이미 등록된 에이전트 ID들

빠른 시작

설정 파일에 broadcast 섹션을 추가하는 것만으로 5분 만에 설정을 끝낼 수 있습니다.

1. 설정 파일의 bindings 옆에 broadcast 섹션을 만드세요.
2. 키 값으로 WhatsApp Peer ID(그룹 JID 또는 전화번호)를 넣고, 값으로 실행할 에이전트 ID 배열을 적어주세요.

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

이제 해당 채팅방에서 OpenClaw가 응답할 타이밍이 되면, 지정된 세 에이전트가 모두 실행됩니다.

주요 기능 알아보기

처리 전략 (Processing Strategy)

에이전트들이 메시지를 처리하는 방식을 두 가지 중 선택할 수 있습니다.

Parallel (기본값)

모든 에이전트가 동시에 메시지를 처리합니다. 속도가 빠릅니다.

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

Sequential

에이전트들이 순서대로 처리합니다. 앞선 에이전트가 작업을 끝내야 다음 에이전트가 시작합니다.

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

세션 격리 (Session Isolation)

Broadcast Groups에 속한 각 에이전트는 완전히 독립된 환경을 가집니다.

• Session keys: 각자 고유한 세션 키를 사용합니다.
• Conversation history: 다른 에이전트가 보낸 메시지는 서로 볼 수 없습니다.
• Workspace: 설정에 따라 별도의 Sandbox를 가집니다.
• Tool access: 에이전트마다 도구 권한을 다르게 줄 수 있습니다.
• Memory/Context: IDENTITY.md나 SOUL.md 같은 컨텍스트가 각자 적용됩니다.

단, 그룹의 최근 대화 내용을 담은 Group context buffer는 공유되므로, 모든 에이전트가 동일한 대화 맥락을 파악하고 작업을 시작합니다.

전체 설정 예시

여러 그룹과 DM에 각기 다른 에이전트 팀을 배치한 예시입니다.

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

문제 해결

에이전트가 응답하지 않아요

• 에이전트 ID 확인: agents.list에 해당 ID가 실제로 있는지 확인하세요.
• Peer ID 형식: 그룹 JID(@g.us)나 E.164 형식의 전화번호가 정확한지 확인하세요.
• 로그 확인: 아래 명령어로 실시간 로그를 확인해 보세요.

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

에이전트가 하나만 응답해요

• 설정 위치 확인: 해당 Peer ID가 bindings에는 있지만 broadcast 섹션에는 없는지 확인하세요. broadcast 설정에 추가해야 여러 에이전트가 작동합니다.

성능이 너무 느려요

• 에이전트 수 조절: 한 그룹당 에이전트를 5~10개 이내로 유지하는 것이 좋습니다.
• 모델 변경: 복잡하지 않은 작업은 Opus 대신 Sonnet 같은 빠른 모델을 사용해 보세요.

---

도움이 더 필요하신가요? AI Setup Assistant에게 물어보세요.

다음 단계

• Multi-Agent Configuration
• Routing Configuration
• Session Management