Группы рассылки

​

Обзор

​

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

​

Базовая настройка

• групповые чаты: 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.

​

Связанные материалы

• Маршрутизация каналов
• Группы
• Инструменты песочницы для нескольких агентов
• Сопряжение
• Управление сеансами