Nhóm Phát Sóng
Trạng thái: Thử nghiệmPhiên bản: Thêm vào 2026.1.9
Tổng Quan
Nhóm Phát Sóng cho phép nhiều agent xử lý và phản hồi cùng một tin nhắn đồng thời. Điều này giúp tạo ra các nhóm agent chuyên biệt làm việc cùng nhau trong một nhóm WhatsApp hoặc tin nhắn trực tiếp — tất cả sử dụng một số điện thoại duy nhất. Phạm vi hiện tại: Chỉ WhatsApp (kênh web). Nhóm phát sóng được đánh giá sau khi danh sách cho phép kênh và quy tắc kích hoạt nhóm được áp dụng. Trong các nhóm WhatsApp, điều này có nghĩa là phát sóng xảy ra khi OpenClaw thường trả lời (ví dụ: khi được nhắc đến, tùy thuộc vào cài đặt nhóm của bạn).Trường Hợp Sử Dụng
1. Nhóm Agent Chuyên Biệt
Triển khai nhiều agent với trách nhiệm cụ thể, tập trung:2. Hỗ Trợ Đa Ngôn Ngữ
3. Quy Trình Đảm Bảo Chất Lượng
4. Tự Động Hóa Nhiệm Vụ
Cấu Hình
Thiết Lập Cơ Bản
Thêm một phầnbroadcast ở cấp cao nhất (bên cạnh bindings). Các khóa là ID peer WhatsApp:
- nhóm chat: JID nhóm (ví dụ:
120363403215116621@g.us) - tin nhắn trực tiếp: số điện thoại E.164 (ví dụ:
+15551234567)
Chiến Lược Xử Lý
Kiểm soát cách các agent xử lý tin nhắn:Song Song (Mặc Định)
Tất cả các agent xử lý đồng thời:Tuần Tự
Các agent xử lý theo thứ tự (một agent chờ agent trước hoàn thành):Ví Dụ Hoàn Chỉnh
Cách Hoạt Động
Luồng Tin Nhắn
- Tin nhắn đến trong một nhóm WhatsApp
- Kiểm tra phát sóng: Hệ thống kiểm tra xem ID peer có trong
broadcastkhông - Nếu có trong danh sách phát sóng:
- Tất cả các agent được liệt kê xử lý tin nhắn
- Mỗi agent có khóa phiên riêng và ngữ cảnh cách ly
- Các agent xử lý song song (mặc định) hoặc tuần tự
- Nếu không có trong danh sách phát sóng:
- Áp dụng định tuyến thông thường (ràng buộc đầu tiên phù hợp)
Cách Ly Phiên
Mỗi agent trong một nhóm phát sóng duy trì hoàn toàn riêng biệt:- Khóa phiên (
agent:alfred:whatsapp:group:120363...so vớiagent:baerbel:whatsapp:group:120363...) - Lịch sử hội thoại (agent không thấy tin nhắn của các agent khác)
- Workspace (các sandbox riêng biệt nếu được cấu hình)
- Truy cập công cụ (danh sách cho phép/chặn khác nhau)
- Bộ nhớ/ngữ cảnh (IDENTITY.md, SOUL.md, v.v. riêng biệt)
- Bộ đệm ngữ cảnh nhóm (tin nhắn nhóm gần đây được sử dụng cho ngữ cảnh) được chia sẻ cho mỗi peer, vì vậy tất cả các agent phát sóng thấy cùng một ngữ cảnh khi được kích hoạt
- Tính cách khác nhau
- 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)
- Kỹ năng cài đặt khác nhau
Ví Dụ: Phiên Cách Ly
Trong nhóm120363403215116621@g.us với các agent ["alfred", "baerbel"]:
Ngữ cảnh của Alfred:
Thực Hành Tốt Nhất
1. Giữ Cho Agent Tập Trung
Thiết kế mỗi agent với một trách nhiệm rõ ràng, duy nhất:❌ Xấu: Một agent “dev-helper” chung chung
2. Sử Dụng Tên Mô Tả
Làm rõ mỗi agent thực hiện công việc gì:3. Cấu Hình Truy Cập Công Cụ Khác Nhau
Chỉ cung cấp cho agent các công cụ cần thiết:4. Giám Sát Hiệu Suất
Với nhiều agent, hãy cân nhắc:- Sử dụng
"strategy": "parallel"(mặc định) để tăng tốc độ - Giới hạn nhóm phát sóng từ 5-10 agent
- Sử dụng mô hình nhanh hơn cho các agent đơn giản
5. Xử Lý Lỗi Một Cách Linh Hoạt
Các agent thất bại độc lập. Lỗi của một agent không chặn các agent khác:Tương Thích
Nhà Cung Cấp
Nhóm phát sóng 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
Nhóm phát sóng hoạt động song song với định tuyến hiện có: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 sóng)
broadcast có ưu tiên hơn bindings.
Khắc Phục Sự Cố
Agent Không Phản Hồi
Kiểm tra:- ID agent tồn tại trong
agents.list - Định dạng ID peer đúng (ví dụ:
120363403215116621@g.us) - Agent không nằm trong danh sách chặn
Chỉ Một Agent Phản Hồi
Nguyên nhân: ID peer có thể nằm trongbindings nhưng không trong broadcast.
Khắc phục: Thêm vào cấu hình phát sóng hoặc xóa khỏi bindings.
Vấn Đề Hiệu Suất
Nếu chậm với nhiều agent:- Giảm số lượng agent mỗi nhóm
- Sử 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 Kiểm Tra Mã
Phản hồi:
- code-formatter: “Đã sửa lỗi thụt lề và thêm gợi ý kiểu”
- security-scanner: “⚠️ Lỗ hổng SQL injection ở dòng 12”
- test-coverage: “Độ phủ là 45%, thiếu kiểm thử 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ữ
Tham Khảo API
Cấu Trúc Cấu Hình
Các Trường
strategy(tùy chọn): Cách xử lý agent"parallel"(mặc định): Tất cả các agent xử lý đồng thời"sequential": Các agent xử lý theo thứ tự trong mảng
[peerId]: JID nhóm WhatsApp, số E.164, hoặc ID peer khác- Giá trị: Mảng ID agent nên xử lý tin nhắn
Giới Hạn
- Số lượng agent tối đa: Không có giới hạn cứng, nhưng 10+ agent có thể chậm
- Ngữ cảnh chia sẻ: Các agent 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ả các agent đều tính vào giới hạn tốc độ của WhatsApp
Cải Tiến Tương Lai
Các tính năng dự kiến:- Chế độ ngữ cảnh chia sẻ (các agent thấy phản hồi của nhau)
- Phối hợp agent (các agent có thể báo hiệu cho nhau)
- Lựa chọn agent động (chọn agent dựa trên nội dung tin nhắn)
- Ưu tiên agent (một số agent phản hồi trước các agent khác)