مجموعات البث
الحالة: تجريبيةالإصدار: أضيفت في 2026.1.9
نظرة عامة
تتيح مجموعات البث لعدة وكلاء معالجة الرسالة نفسها والرد عليها في الوقت نفسه. يتيح لك ذلك إنشاء فرق وكلاء متخصصة تعمل معًا داخل مجموعة WhatsApp واحدة أو رسالة خاصة — وكل ذلك باستخدام رقم هاتف واحد. النطاق الحالي: WhatsApp فقط (قناة الويب). تُقيَّم مجموعات البث بعد قوائم السماح الخاصة بالقنوات وقواعد تفعيل المجموعات. في مجموعات WhatsApp، يعني هذا أن عمليات البث تحدث عندما يكون OpenClaw سيرد عادةً (على سبيل المثال: عند الإشارة، حسب إعدادات مجموعتك).حالات الاستخدام
1. فرق الوكلاء المتخصصة
انشر عدة وكلاء بمسؤوليات محددة ومركزة:2. دعم متعدد اللغات
3. سير عمل ضمان الجودة
4. أتمتة المهام
التكوين
الإعداد الأساسي
أضف قسمbroadcast على المستوى الأعلى (بجانب bindings). المفاتيح هي معرّفات نظير WhatsApp:
- محادثات المجموعات: group JID (مثل
120363403215116621@g.us) - الرسائل الخاصة: رقم هاتف بتنسيق E.164 (مثل
+15551234567)
استراتيجية المعالجة
تحكم في كيفية معالجة الوكلاء للرسائل:بالتوازي (الافتراضي)
يعالج جميع الوكلاء الرسائل في الوقت نفسه:بالتسلسل
يعالج الوكلاء الرسائل بالترتيب (ينتظر أحدهم انتهاء السابق):مثال كامل
كيف يعمل
تدفق الرسائل
- تصل رسالة واردة في مجموعة WhatsApp
- فحص البث: يتحقق النظام مما إذا كان معرّف النظير موجودًا في
broadcast - إذا كان في قائمة البث:
- يعالج جميع الوكلاء المدرجين الرسالة
- لكل وكيل مفتاح جلسة خاص به وسياق معزول
- يعالج الوكلاء الرسائل بالتوازي (افتراضيًا) أو بالتسلسل
- إذا لم يكن في قائمة البث:
- يُطبَّق التوجيه العادي (أول binding مطابق)
عزل الجلسات
يحافظ كل وكيل في مجموعة بث على فصل كامل لما يلي:- مفاتيح الجلسات (
agent:alfred:whatsapp:group:120363...مقابلagent:baerbel:whatsapp:group:120363...) - سجل المحادثة (الوكيل لا يرى رسائل الوكلاء الآخرين)
- مساحة العمل (بيئات معزولة منفصلة إذا تم تكوينها)
- الوصول إلى الأدوات (قوائم سماح/منع مختلفة)
- الذاكرة/السياق (
IDENTITY.mdوSOUL.mdوما إلى ذلك بشكل منفصل) - مخزن سياق المجموعة (رسائل المجموعة الحديثة المستخدمة للسياق) يكون مشتركًا لكل نظير، لذا يرى جميع وكلاء البث السياق نفسه عند التشغيل
- شخصيات مختلفة
- وصولًا مختلفًا إلى الأدوات (مثل للقراءة فقط مقابل القراءة والكتابة)
- نماذج مختلفة (مثل opus مقابل sonnet)
- Skills مختلفة مثبّتة
مثال: جلسات معزولة
في المجموعة120363403215116621@g.us مع الوكلاء ["alfred", "baerbel"]:
سياق Alfred:
أفضل الممارسات
1. أبقِ الوكلاء مركّزين
صمّم كل وكيل بحيث تكون له مسؤولية واحدة وواضحة:❌ سيئ: وكيل عام واحد باسم “dev-helper”
2. استخدم أسماء وصفية
اجعل وظيفة كل وكيل واضحة:3. كوّن وصولًا مختلفًا إلى الأدوات
امنح الوكلاء الأدوات التي يحتاجونها فقط:4. راقب الأداء
مع وجود عدد كبير من الوكلاء، ضع في اعتبارك ما يلي:- استخدام
"strategy": "parallel"(الافتراضي) للسرعة - حصر مجموعات البث في 5-10 وكلاء
- استخدام نماذج أسرع للوكلاء الأبسط
5. تعامل مع الإخفاقات بسلاسة
يفشل الوكلاء بشكل مستقل. لا يمنع خطأ أحد الوكلاء الآخرين:التوافق
المزوّدون
تعمل مجموعات البث حاليًا مع:- ✅ WhatsApp (منفذ)
- 🚧 Telegram (مخطط له)
- 🚧 Discord (مخطط له)
- 🚧 Slack (مخطط له)
التوجيه
تعمل مجموعات البث إلى جانب التوجيه الحالي:GROUP_A: يرد alfred فقط (توجيه عادي)GROUP_B: يرد agent1 وagent2 معًا (بث)
broadcast الأولوية على bindings.
استكشاف الأخطاء وإصلاحها
الوكلاء لا يردون
تحقق من:- وجود معرّفات الوكلاء في
agents.list - صحة تنسيق معرّف النظير (مثل
120363403215116621@g.us) - عدم وجود الوكلاء في قوائم المنع
وكيل واحد فقط يرد
السبب: قد يكون معرّف النظير موجودًا فيbindings ولكن ليس في broadcast.
الحل: أضفه إلى تكوين البث أو أزله من bindings.
مشكلات الأداء
إذا كان الأداء بطيئًا مع عدد كبير من الوكلاء:- قلّل عدد الوكلاء لكل مجموعة
- استخدم نماذج أخف (sonnet بدلًا من opus)
- تحقق من وقت بدء تشغيل sandbox
أمثلة
المثال 1: فريق مراجعة الشيفرة
الردود:
- code-formatter: “Fixed indentation and added type hints”
- security-scanner: “⚠️ SQL injection vulnerability in line 12”
- test-coverage: “Coverage is 45%, missing tests for error cases”
- docs-checker: “Missing docstring for function
process_data”
المثال 2: دعم متعدد اللغات
مرجع API
مخطط التكوين
الحقول
strategy(اختياري): كيفية معالجة الوكلاء"parallel"(افتراضي): يعالج جميع الوكلاء في الوقت نفسه"sequential": يعالج الوكلاء وفق ترتيبهم في المصفوفة
[peerId]: group JID لـ WhatsApp، أو رقم E.164، أو معرّف نظير آخر- القيمة: مصفوفة من معرّفات الوكلاء الذين يجب أن يعالجوا الرسائل
القيود
- الحد الأقصى للوكلاء: لا يوجد حد صارم، لكن 10+ وكلاء قد يكونون بطيئين
- السياق المشترك: لا يرى الوكلاء ردود بعضهم البعض (عن قصد)
- ترتيب الرسائل: قد تصل الردود المتوازية بأي ترتيب
- حدود المعدل: تُحتسب جميع الوكلاء ضمن حدود معدل WhatsApp
تحسينات مستقبلية
الميزات المخطط لها:- وضع السياق المشترك (يرى الوكلاء ردود بعضهم البعض)
- تنسيق الوكلاء (يمكن للوكلاء إرسال إشارات إلى بعضهم البعض)
- اختيار ديناميكي للوكلاء (اختيار الوكلاء بناءً على محتوى الرسالة)
- أولويات الوكلاء (يرد بعض الوكلاء قبل الآخرين)