Skip to content

브로드캐스트 그룹

브로드캐스트 그룹을 사용하면 OpenClaw가 정상적으로 응답할 때(언급/활성화 게이팅 후) 동일한 피어에 대해 여러 에이전트를 실행할 수 있습니다.

사용 사례

  • WhatsApp 그룹 채팅에서 두 개의 AI 에이전트가 협업
  • 모든 메시지를 로그 에이전트에 미러링
  • 특정 그룹 채팅에서 기본 에이전트 + 특수 에이전트 실행

구성

json5
{
  broadcast: {
    strategy: "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"],
    "+15555550123": ["support", "logger"],
  },
}

옵션

  • strategy: "parallel" (기본값) - 모든 에이전트가 동시에 실행됩니다.
  • 키: 채널별 피어 ID (예: WhatsApp 그룹 ID, 전화번호).
  • 값: 이 피어에 대해 실행할 에이전트 ID 목록.

작동 방식

  1. 인바운드 메시지가 도착하고 일반 활성화 게이팅을 통과합니다.
  2. OpenClaw는 정상적으로 라우팅된 에이전트를 결정합니다.
  3. broadcast 구성에 피어 항목이 있는 경우, OpenClaw는 나열된 모든 에이전트를 실행합니다.
  4. 각 에이전트는 자체 세션 컨텍스트로 독립적으로 실행됩니다.
  5. 각 에이전트의 응답이 독립적으로 전달됩니다.

세션 격리

각 에이전트는 자체 격리된 세션을 유지합니다. 브로드캐스트 그룹의 에이전트들은 세션 상태를 공유하지 않습니다.

중요 사항

  • 브로드캐스트 전략이 "parallel"인 경우 응답 순서가 보장되지 않습니다.
  • 나열된 각 에이전트는 agents.list에 정의되어 있어야 합니다.
  • 브로드캐스트는 메시지가 정상적인 게이팅 및 허용 목록 확인을 통과한 후에만 발생합니다.
  • 피어 ID 형식은 채널에 따라 다릅니다:
    • WhatsApp 그룹: 120363403215116621@g.us
    • 전화번호: +15555550123
    • Telegram 그룹: -1001234567890

관련 문서