Nhóm phát sóng

Tổng quan

Nhóm phát rộng chạy nhiều tác tử trên cùng một tin nhắn đến. Mỗi tác tử xử lý tin nhắn trong phiên cô lập riêng và đăng phản hồi riêng, nhờ đó một số WhatsApp có thể lưu trữ một nhóm tác tử chuyên biệt trong một cuộc trò chuyện nhóm hoặc tin nhắn trực tiếp duy nhất.

Nhóm phát rộng được đánh giá sau danh sách cho phép của kênh và quy tắc kích hoạt nhóm. Trong nhóm WhatsApp, việc phát rộng xảy ra khi OpenClaw thông thường sẽ phản hồi (ví dụ: khi được nhắc đến, tùy thuộc vào cài đặt nhóm của bạn). Chúng chỉ thay đổi tác tử nào chạy, không bao giờ thay đổi việc một tin nhắn có đủ điều kiện để được xử lý hay không.

Luồng QA WhatsApp trực tiếp bao gồm whatsapp-broadcast-group-fanout, xác minh rằng một tin nhắn nhóm có nhắc đến có thể tạo ra các phản hồi hiển thị riêng biệt từ hai tác tử đã cấu hình.

Cấu hình

Thiết lập cơ bản

Thêm phần broadcast ở cấp cao nhất (bên cạnh bindings). Khóa là mã định danh đối tác WhatsApp, giá trị là mảng mã định danh tác tử:

• cuộc trò chuyện nhóm: JID nhóm (ví dụ: 120363403215116621@g.us)
• tin nhắn trực tiếp: số điện thoại E.164 của người gửi (ví dụ: +15551234567)

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

Kết quả: khi OpenClaw thông thường sẽ phản hồi trong cuộc trò chuyện này, hệ thống chạy cả ba tác tử.

Mọi mã định danh tác tử được liệt kê đều phải tồn tại trong agents.list: quy trình xác thực cấu hình sẽ báo cáo các mã định danh không xác định và môi trường chạy sẽ bỏ qua chúng với cảnh báo Broadcast agent <id> not found in agents.list; skipping.

Chiến lược xử lý

broadcast.strategy thiết lập cách các tác tử xử lý tin nhắn:

{  "broadcast": {    "strategy": "sequential",    "120363403215116621@g.us": ["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",    "120363403215116621@g.us": ["code-reviewer", "security-auditor", "docs-generator"],    "120363424282127706@g.us": ["support-en", "support-de"],    "+15555550123": ["assistant", "logger"]  }}

Cách hoạt động

Luồng tin nhắn

Cô lập phiên

Mỗi tác tử trong một nhóm phát rộng duy trì hoàn toàn riêng 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 (một tác tử không thấy phản hồi của các tác tử khác)
• Không gian làm việc (các sandbox riêng nếu được cấu hình)
• Quyền truy cập công cụ (các danh sách cho phép/từ chối khác nhau)
• Bộ nhớ/ngữ cảnh (IDENTITY.md, SOUL.md, v.v. riêng biệt)

Có một ngoại lệ được chủ ý chia sẻ: bộ đệm ngữ cảnh nhóm (các tin nhắn nhóm gần đây dùng làm ngữ cảnh) được chia sẻ theo từng đối tác, vì vậy tất cả tác tử phát rộng nhìn thấy cùng một ngữ cảnh khi được kích hoạt. Bộ đệm được xóa một lần sau khi quá trình phân phối hoàn tất.

Điều này cho phép mỗi tác tử có tính cách, mô hình, Skills và quyền truy cập công cụ khác nhau (ví dụ: chỉ đọc so với đọc-ghi).

Ví dụ: các phiên cô lập

Trong nhóm 120363403215116621@g.us với các tác tử ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: ~/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: ~/openclaw-baerbel/Tools: read only

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

• Nhóm tác tử chuyên biệt: một nhóm phát triển nơi code-reviewer, security-auditor, test-generator và docs-checker cùng trả lời một tin nhắn từ góc nhìn riêng.
• Hỗ trợ đa ngôn ngữ: một cuộc trò chuyện hỗ trợ với support-en, support-de, support-es phản hồi bằng ngôn ngữ tương ứng.
• Đảm bảo chất lượng: support-agent trả lời trong khi qa-agent đánh giá và chỉ phản hồi khi phát hiện vấn đề.
• Tự động hóa tác vụ: task-tracker, time-logger và report-generator cùng tiếp nhận một bản cập nhật trạng thái.

Phương pháp hay nhất

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

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

Nhà cung cấp

Nhóm phát rộng hiện chỉ được triển khai cho WhatsApp (kênh web). Các kênh khác bỏ qua cấu hình broadcast.

Định tuyến

Nhóm phát rộng hoạt động cùng với cơ chế đị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 phản hồi (phát rộng).

Khắc phục sự cố

openclaw logs --follow | grep -i broadcast

Ví dụ

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

Tham chiếu API

Lược đồ cấu hình

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

Trường

Giới hạn

1. Số tác tử tối đa: không có giới hạn cứng, nhưng nhiều tác tử (10+) có thể làm hệ thống chậm.
2. Ngữ cảnh dùng chung: các tác tử không thấy phản hồi của nhau (theo thiết kế).
3. Thứ tự tin nhắn: các phản hồi song song có thể đến theo bất kỳ thứ tự nào.
4. Giới hạn tốc độ: tất cả phản hồi đều đến từ một tài khoản WhatsApp, vì vậy phản hồi của mỗi tác tử đều được tính vào cùng giới hạn tốc độ của WhatsApp.

Liên quan

• Định tuyến kênh
• Nhóm
• Công cụ sandbox đa tác tử
• Ghép đôi
• Quản lý phiên