Групи розсилки

​

Огляд

​

Конфігурація

​

Базове налаштування

• групові чати: груповий JID (наприклад, 120363403215116621@g.us)
• приватні повідомлення: номер телефону відправника у форматі E.164 (наприклад, +15551234567)

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

​

Стратегія обробки

{
  "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 тощо)

​

Приклад: ізольовані сеанси

Сеанс: agent:alfred:whatsapp:group:120363403215116621@g.us
Історія: [повідомлення користувача, попередні відповіді alfred]
Робочий простір: ~/openclaw-alfred/
Інструменти: читання, запис, виконання

Сеанс: agent:baerbel:whatsapp:group:120363403215116621@g.us
Історія: [повідомлення користувача, попередні відповіді baerbel]
Робочий простір: ~/openclaw-baerbel/
Інструменти: лише читання

​

Варіанти використання

• Команди спеціалізованих агентів: група розробників, у якій 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"] } }
    ]
  }
}

​

Сумісність

​

Постачальники

​

Маршрутизація

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

​

Пов’язані матеріали

• Маршрутизація каналів
• Групи
• Інструменти пісочниці для кількох агентів
• Сполучення
• Керування сеансами