메인 콘텐츠로 건너뛰기

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.

상태: 실험적 기능. 2026.1.9에 추가됨.

​
개요

브로드캐스트 그룹을 사용하면 여러 에이전트가 동일한 메시지를 동시에 처리하고 응답할 수 있습니다. 이를 통해 하나의 WhatsApp 그룹 또는 DM에서 함께 작업하는 전문 에이전트 팀을 만들 수 있으며, 모두 하나의 전화번호를 사용합니다. 현재 범위: WhatsApp만 해당(웹 채널). 브로드캐스트 그룹은 채널 허용 목록과 그룹 활성화 규칙 이후에 평가됩니다. WhatsApp 그룹에서는 OpenClaw가 일반적으로 응답할 때 브로드캐스트가 발생한다는 의미입니다(예: 그룹 설정에 따라 멘션 시).

​
사용 사례

원자적이고 집중된 책임을 가진 여러 에이전트를 배포합니다.
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)

​
구성

​
기본 설정

최상위 broadcast 섹션을 추가합니다(bindings 옆). 키는 WhatsApp 피어 ID입니다.
  • 그룹 채팅: 그룹 JID(예: 120363403215116621@g.us)
  • DM: E.164 전화번호(예: +15551234567)
{
  "broadcast": {
    "120363403215116621@g.us": ["alfred", "baerbel", "assistant3"]
  }
}
결과: OpenClaw가 이 채팅에서 응답할 때 세 에이전트를 모두 실행합니다.

​
처리 전략

에이전트가 메시지를 처리하는 방식을 제어합니다.
모든 에이전트가 동시에 처리합니다.
{
  "broadcast": {
    "strategy": "parallel",
    "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"]
  }
}

​
작동 방식

​
메시지 흐름

1

수신 메시지 도착

WhatsApp 그룹 또는 DM 메시지가 도착합니다.
2

브로드캐스트 확인

시스템이 피어 ID가 broadcast에 있는지 확인합니다.
3

브로드캐스트 목록에 있는 경우

  • 나열된 모든 에이전트가 메시지를 처리합니다.
  • 각 에이전트에는 고유한 세션 키와 격리된 컨텍스트가 있습니다.
  • 에이전트는 병렬(기본값) 또는 순차적으로 처리합니다.
4

브로드캐스트 목록에 없는 경우

일반 라우팅이 적용됩니다(첫 번째로 일치하는 바인딩).
브로드캐스트 그룹은 채널 허용 목록이나 그룹 활성화 규칙(멘션/명령 등)을 우회하지 않습니다. 메시지가 처리 대상일 때 어떤 에이전트가 실행되는지 만 변경합니다.

​
세션 격리

브로드캐스트 그룹의 각 에이전트는 다음을 완전히 별도로 유지합니다.
  • 세션 키(agent:alfred:whatsapp:group:120363... vs agent:baerbel:whatsapp:group:120363...)
  • 대화 기록(에이전트는 다른 에이전트의 메시지를 보지 않음)
  • 작업공간(구성된 경우 별도 샌드박스)
  • 도구 접근(서로 다른 허용/거부 목록)
  • 메모리/컨텍스트(별도 IDENTITY.md, SOUL.md 등)
  • 그룹 컨텍스트 버퍼(컨텍스트에 사용되는 최근 그룹 메시지)는 피어별로 공유되므로, 모든 브로드캐스트 에이전트는 트리거될 때 동일한 컨텍스트를 봅니다.
이를 통해 각 에이전트는 다음을 가질 수 있습니다.
  • 서로 다른 성격
  • 서로 다른 도구 접근(예: 읽기 전용 vs. 읽기/쓰기)
  • 서로 다른 모델(예: opus vs. sonnet)
  • 서로 다른 Skills 설치

​
예시: 격리된 세션

120363403215116621@g.us 그룹에서 에이전트가 ["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

​
모범 사례

각 에이전트를 하나의 명확한 책임으로 설계합니다.
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ 좋음: 각 에이전트는 하나의 작업을 담당합니다. ❌ 나쁨: 하나의 범용 “dev-helper” 에이전트.
각 에이전트가 무엇을 하는지 명확하게 합니다.
{
  "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"] }
    }
  }
}
reviewer는 읽기 전용입니다. fixer는 읽고 쓸 수 있습니다.
에이전트가 많은 경우 다음을 고려하세요.
  • 속도를 위해 "strategy": "parallel"(기본값) 사용
  • 브로드캐스트 그룹을 5~10개 에이전트로 제한
  • 더 단순한 에이전트에는 더 빠른 모델 사용
에이전트는 독립적으로 실패합니다. 한 에이전트의 오류가 다른 에이전트를 차단하지 않습니다.
Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

​
호환성

​
제공자

브로드캐스트 그룹은 현재 다음과 함께 작동합니다.
  • ✅ WhatsApp(구현됨)
  • 🚧 Telegram(계획됨)
  • 🚧 Discord(계획됨)
  • 🚧 Slack(계획됨)

​
라우팅

브로드캐스트 그룹은 기존 라우팅과 함께 작동합니다. 
{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}
  • GROUP_A: alfred만 응답합니다(일반 라우팅).
  • GROUP_B: agent1과 agent2가 응답합니다(브로드캐스트).
우선순위: broadcast가 bindings보다 우선합니다.

​
문제 해결

확인:
  1. 에이전트 ID가 agents.list에 존재합니다.
  2. 피어 ID 형식이 올바릅니다(예: 120363403215116621@g.us).
  3. 에이전트가 거부 목록에 없습니다.
디버그:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
원인: 피어 ID가 bindings에는 있지만 broadcast에는 없을 수 있습니다.해결: 브로드캐스트 구성에 추가하거나 바인딩에서 제거합니다.
많은 에이전트로 인해 느린 경우:
  • 그룹당 에이전트 수를 줄입니다.
  • 더 가벼운 모델을 사용합니다(opus 대신 sonnet).
  • 샌드박스 시작 시간을 확인합니다.

​
예시

{
  "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"] } }
    ]
  }
}
사용자 전송: 코드 스니펫.응답:
  • code-formatter: “들여쓰기를 수정하고 타입 힌트를 추가했습니다”
  • security-scanner: “⚠️ 12번째 줄에 SQL 삽입 취약점이 있습니다”
  • test-coverage: “커버리지가 45%이며 오류 사례에 대한 테스트가 없습니다”
  • docs-checker: “process_data 함수의 docstring이 없습니다”
{
  "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[];
  };
}

​
필드

​
strategy
"parallel" | "sequential"
기본값:"\"parallel\""
에이전트를 처리하는 방식입니다. parallel은 모든 에이전트를 동시에 실행하고, sequential은 배열 순서대로 실행합니다.
​
[peerId]
string[]
WhatsApp 그룹 JID, E.164 번호 또는 기타 피어 ID입니다. 값은 메시지를 처리해야 하는 에이전트 ID의 배열입니다.

​
제한 사항

  1. 최대 에이전트 수: 엄격한 제한은 없지만, 에이전트가 10개 이상이면 느릴 수 있습니다.
  2. 공유 컨텍스트: 에이전트는 서로의 응답을 보지 않습니다(의도된 설계).
  3. 메시지 순서: 병렬 응답은 임의의 순서로 도착할 수 있습니다.
  4. 속도 제한: 모든 에이전트가 WhatsApp 속도 제한에 포함됩니다.

​
향후 개선 사항

계획된 기능:
  • 공유 컨텍스트 모드(에이전트가 서로의 응답을 봄)
  • 에이전트 조정(에이전트가 서로에게 신호를 보낼 수 있음)
  • 동적 에이전트 선택(메시지 내용에 따라 에이전트 선택)
  • 에이전트 우선순위(일부 에이전트가 다른 에이전트보다 먼저 응답)

​
관련