Nhóm Phát Sóng

Trạng thái: Thử nghiệm
Phiên bản: Được thêm trong 2026.1.9

Tổng quan

Broadcast Groups enable multiple agents to process and respond to the same message simultaneously. This allows you to create specialized agent teams that work together in a single WhatsApp group or DM — all using one phone number. Phạm vi hiện tại: Chỉ WhatsApp (kênh web). Broadcast groups are evaluated after channel allowlists and group activation rules. In WhatsApp groups, this means broadcasts happen when OpenClaw would normally reply (for example: on mention, depending on your group settings).

Trường hợp sử dụng

1. Specialized Agent Teams

Triển khai nhiều tác tử với trách nhiệm nguyên tử, tập trung:

Group: "Development Team"
Agents:
  - CodeReviewer (reviews code snippets)
  - DocumentationBot (generates docs)
  - SecurityAuditor (checks for vulnerabilities)
  - TestGenerator (suggests test cases)

Mỗi tác tử xử lý cùng một tin nhắn và cung cấp góc nhìn chuyên môn riêng của mình.

2. Multi-Language Support

Group: "International Support"
Agents:
  - Agent_EN (responds in English)
  - Agent_DE (responds in German)
  - Agent_ES (responds in Spanish)

3. Quality Assurance Workflows

Group: "Customer Support"
Agents:
  - SupportAgent (provides answer)
  - QAAgent (reviews quality, only responds if issues found)

4. Task Automation

Group: "Project Management"
Agents:
  - TaskTracker (updates task database)
  - TimeLogger (logs time spent)
  - ReportGenerator (creates summaries)

Cấu hình

Thiết lập cơ bản

Thêm một mục broadcast ở cấp cao nhất (bên cạnh bindings). Keys are WhatsApp peer ids:

chat nhóm: JID của nhóm (ví dụ: [email protected])
DM: số điện thoại chuẩn E.164 (ví dụ: +15551234567)

{
  "broadcast": {
    "[email protected]": ["alfred", "baerbel", "assistant3"]
  }
}

Kết quả: Khi OpenClaw sẽ phản hồi trong cuộc trò chuyện này, nó sẽ chạy cả ba tác tử.

Chiến lược xử lý

Kiểm soát cách các tác tử xử lý tin nhắn:

Song song (Mặc định)

Tất cả các tác tử xử lý đồng thời:

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": ["alfred", "baerbel"]
  }
}

Tuần tự

Các tác tử xử lý theo thứ tự (tác tử sau chờ tác tử trước hoàn thành):

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["alfred", "baerbel"]
  }
}

Ví dụ hoàn chỉnh

{
  "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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

Cách hoạt động

Luồng tin nhắn

Tin nhắn đến xuất hiện trong một nhóm WhatsApp
Kiểm tra broadcast: Hệ thống kiểm tra xem peer ID có nằm trong broadcast hay không
Nếu nằm trong danh sách broadcast:
- Tất cả các tác tử được liệt kê đều xử lý tin nhắn
- Mỗi tác tử có khóa phiên riêng và ngữ cảnh tách biệt
- Các tác tử xử lý song song (mặc định) hoặc tuần tự
Nếu không nằm trong danh sách broadcast:
- Áp dụng định tuyến thông thường (binding khớp đầu tiên)

Note: broadcast groups do not bypass channel allowlists or group activation rules (mentions/commands/etc). They only change which agents run when a message is eligible for processing.

Cách ly phiên

Mỗi tác tử trong một broadcast group duy trì hoàn toàn tách biệt:

Khóa phiên (agent:alfred:whatsapp:group:120363... so với agent:baerbel:whatsapp:group:120363...)
Lịch sử hội thoại (tác tử không thấy tin nhắn của tác tử khác)
Không gian làm việc (sandbox riêng nếu được cấu hình)
Quyền truy cập công cụ (danh sách cho phép/từ chối khác nhau)
Bộ nhớ/ngữ cảnh (IDENTITY.md, SOUL.md riêng biệt, v.v.)
Bộ đệm ngữ cảnh nhóm (các tin nhắn nhóm gần đây dùng cho ngữ cảnh) được chia sẻ theo từng peer, vì vậy tất cả các tác tử broadcast đều thấy cùng một ngữ cảnh khi được kích hoạt

Điều này cho phép mỗi tác tử có:

Cá tính khác nhau
Quyền truy cập công cụ khác nhau (ví dụ: chỉ đọc so với đọc-ghi)
Mô hình khác nhau (ví dụ: opus so với sonnet)
Các Skills khác nhau được cài đặt

Ví dụ: Các phiên được cách ly

Trong nhóm [email protected] với các tác tử ["alfred", "baerbel"]: Ngữ cảnh của Alfred:

Session: agent:alfred:whatsapp:group:[email protected]
History: [user message, alfred's previous responses]
Workspace: /Users/pascal/openclaw-alfred/
Tools: read, write, exec

Ngữ cảnh của Bärbel:

Session: agent:baerbel:whatsapp:group:[email protected]
History: [user message, baerbel's previous responses]
Workspace: /Users/pascal/openclaw-baerbel/
Tools: read only

Thực hành tốt nhất

1. Giữ cho các Agent tập trung

Thiết kế mỗi tác tử với một trách nhiệm rõ ràng, duy nhất:

{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}

✅ Tốt: Mỗi tác tử có một nhiệm vụ
❌ Không tốt: Một tác tử “dev-helper” chung chung

2. 2. Use Descriptive Names

Làm rõ mỗi tác tử làm gì:

{
  "agents": {
    "security-scanner": { "name": "Security Scanner" },
    "code-formatter": { "name": "Code Formatter" },
    "test-generator": { "name": "Test Generator" }
  }
}

3. 38. Cấu hình quyền truy cập tool khác nhau

Chỉ cấp cho tác tử những công cụ chúng cần:

{
  "agents": {
    "reviewer": {
      "tools": { "allow": ["read", "exec"] } // Read-only
    },
    "fixer": {
      "tools": { "allow": ["read", "write", "edit", "exec"] } // Read-write
    }
  }
}

4. 4. 39. Giám sát hiệu năng

Với nhiều tác tử, hãy cân nhắc:

Sử dụng "strategy": "parallel" (mặc định) để có tốc độ
Giới hạn broadcast groups ở mức 5–10 tác tử
Dùng mô hình nhanh hơn cho các tác tử đơn giản

40. 5. 41. Xử lý lỗi một cách nhẹ nhàng

Các agent thất bại độc lập. 43. Lỗi của một agent không chặn các agent khác:

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

Khả năng tương thích

Nhà cung cấp

Broadcast groups hiện hoạt động với:

✅ WhatsApp (đã triển khai)
🚧 Telegram (dự kiến)
🚧 Discord (dự kiến)
🚧 Slack (dự kiến)

Định tuyến

Broadcast groups hoạt động song song với định tuyến hiện có:

{
  "bindings": [
    {
      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },
      "agentId": "alfred"
    }
  ],
  "broadcast": {
    "GROUP_B": ["agent1", "agent2"]
  }
}

GROUP_A: Chỉ alfred phản hồi (định tuyến thông thường)
GROUP_B: agent1 VÀ agent2 cùng phản hồi (broadcast)

Thứ tự ưu tiên: broadcast có ưu tiên cao hơn bindings.

Xử lý sự cố

Tác tử không phản hồi

Kiểm tra:

ID tác tử tồn tại trong agents.list
Định dạng peer ID chính xác (ví dụ: [email protected])
Tác tử không nằm trong danh sách từ chối

Gỡ lỗi:

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

Chỉ một tác tử phản hồi

Nguyên nhân: Peer ID có thể nằm trong bindings nhưng không nằm trong broadcast. Cách khắc phục: Thêm vào cấu hình broadcast hoặc loại bỏ khỏi bindings.

Vấn đề hiệu năng

Nếu chậm khi có nhiều tác tử:

Giảm số lượng tác tử mỗi nhóm
Dùng mô hình nhẹ hơn (sonnet thay vì opus)
Kiểm tra thời gian khởi động sandbox

Ví dụ

Ví dụ 1: Nhóm review mã nguồn

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": [
      "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"] } }
    ]
  }
}

Người dùng gửi: Đoạn mã
Phản hồi:

code-formatter: “Đã sửa thụt lề và thêm type hints”
security-scanner: “⚠️ Lỗ hổng SQL injection ở dòng 12”
test-coverage: “Độ bao phủ là 45%, thiếu test cho các trường hợp lỗi”
docs-checker: “Thiếu docstring cho hàm process_data”

Ví dụ 2: Hỗ trợ đa ngôn ngữ

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

Tham chiếu API

Schema cấu hình

interface OpenClawConfig {
  broadcast?: {
    strategy?: "parallel" | "sequential";
    [peerId: string]: string[];
  };
}

Các trường

strategy (tùy chọn): Cách xử lý các tác tử
- "parallel" (mặc định): Tất cả tác tử xử lý đồng thời
- "sequential": Các tác tử xử lý theo thứ tự trong mảng
[peerId]: JID nhóm WhatsApp, số E.164, hoặc peer ID khác
- Giá trị: Mảng ID tác tử nên xử lý tin nhắn

Giới hạn

Số tác tử tối đa: Không có giới hạn cứng, nhưng 10+ tác tử có thể chậm
Ngữ cảnh chia sẻ: Các tác tử không thấy phản hồi của nhau (theo thiết kế)
Thứ tự tin nhắn: Phản hồi song song có thể đến theo bất kỳ thứ tự nào
Giới hạn tốc độ: Tất cả tác tử đều tính vào giới hạn tốc độ của WhatsApp

Cải tiến trong tương lai

Các tính năng dự kiến:

Chế độ ngữ cảnh chia sẻ (các tác tử thấy phản hồi của nhau)
Điều phối tác tử (các tác tử có thể báo hiệu cho nhau)
Lựa chọn tác tử động (chọn tác tử dựa trên nội dung tin nhắn)
Ưu tiên tác tử (một số tác tử phản hồi trước các tác tử khác)

Tổng quan

Nền tảng nhắn tin

Cấu hình

​Nhóm Phát Sóng

​Tổng quan

​Trường hợp sử dụng

​1. Specialized Agent Teams

​2. Multi-Language Support

​3. Quality Assurance Workflows

​4. Task Automation

​Cấu hình

​Thiết lập cơ bản

​Chiến lược xử lý

​Song song (Mặc định)

​Tuần tự

​Ví dụ hoàn chỉnh

​Cách hoạt động

​Luồng tin nhắn

​Cách ly phiên

​Ví dụ: Các phiên được cách ly

​Thực hành tốt nhất

​1. Giữ cho các Agent tập trung

​2. 2. Use Descriptive Names

​3. 38. Cấu hình quyền truy cập tool khác nhau

​4. 4. 39. Giám sát hiệu năng

​40. 5. 41. Xử lý lỗi một cách nhẹ nhàng

​Khả năng tương thích

​Nhà cung cấp

​Định tuyến

​Xử lý sự cố

​Tác tử không phản hồi

​Chỉ một tác tử phản hồi

​Vấn đề hiệu năng

​Ví dụ

​Ví dụ 1: Nhóm review mã nguồn

​Ví dụ 2: Hỗ trợ đa ngôn ngữ

​Tham chiếu API

​Schema cấu hình

​Các trường

​Giới hạn

​Cải tiến trong tương lai

​Xem thêm

Nhóm Phát Sóng

Tổng quan

Trường hợp sử dụng

1. Specialized Agent Teams

2. Multi-Language Support

3. Quality Assurance Workflows

4. Task Automation

Cấu hình

Thiết lập cơ bản

Chiến lược xử lý

Song song (Mặc định)

Tuần tự

Ví dụ hoàn chỉnh

Cách hoạt động

Luồng tin nhắn

Cách ly phiên

Ví dụ: Các phiên được cách ly

Thực hành tốt nhất

1. Giữ cho các Agent tập trung

2. 2. Use Descriptive Names

3. 38. Cấu hình quyền truy cập tool khác nhau

4. 4. 39. Giám sát hiệu năng

40. 5. 41. Xử lý lỗi một cách nhẹ nhàng

Khả năng tương thích

Nhà cung cấp

Định tuyến

Xử lý sự cố

Tác tử không phản hồi

Chỉ một tác tử phản hồi

Vấn đề hiệu năng

Ví dụ

Ví dụ 1: Nhóm review mã nguồn

Ví dụ 2: Hỗ trợ đa ngôn ngữ

Tham chiếu API

Schema cấu hình

Các trường

Giới hạn

Cải tiến trong tương lai

Xem thêm