مجموعات البثّ
الحالة: تجريبيالإصدار: أُضيف في 2026.1.9
نظرة عامة
تُمكّن مجموعات البثّ عدة وكلاء من معالجة الرسالة نفسها والردّ عليها في الوقت نفسه. يتيح لك ذلك إنشاء فرق وكلاء متخصصة تعمل معًا داخل مجموعة WhatsApp واحدة أو محادثة مباشرة — وكل ذلك باستخدام رقم هاتف واحد. النطاق الحالي: WhatsApp فقط (قناة الويب). يتم تقييم مجموعات البثّ بعد قوائم السماح الخاصة بالقناة وقواعد تفعيل المجموعات. في مجموعات WhatsApp، يعني هذا أن البثّ يحدث عندما يكون OpenClaw سيقوم بالردّ عادةً (على سبيل المثال: عند الذكر، بحسب إعدادات مجموعتك).حالات الاستخدام
1. فرق وكلاء متخصصة
نشر عدة وكلاء بمهام ذرّية ومركّزة:2. دعم متعدد اللغات
3. سير عمل ضمان الجودة
4. أتمتة المهام
التهيئة
الإعداد الأساسي
أضِف قسمًا علويًا باسمbroadcast (بجوار bindings). المفاتيح هي مُعرّفات أقران WhatsApp:
- محادثات المجموعات: JID للمجموعة (مثل
[email protected]) - DM: E.164 رقم الهاتف (على سبيل المثال
+15551234567)
استراتيجية المعالجة
التحكم في كيفية معالجة الوكلاء للرسائل:المتوازي (افتراضي)
يعالج جميع الوكلاء الرسالة في الوقت نفسه:التسلسلي
يعالج الوكلاء الرسائل بالترتيب (ينتظر كل واحد اكتمال السابق):مثال كامل
كيف يعمل
تدفّق الرسائل
- رسالة واردة تصل إلى مجموعة WhatsApp
- فحص البثّ: يتحقق النظام مما إذا كان مُعرّف النظير ضمن
broadcast - إذا كان ضمن قائمة البثّ:
- يعالج جميع الوكلاء المدرجين الرسالة
- لكل وكيل مفتاح جلسة خاص وسياق معزول
- تتم المعالجة بالتوازي (افتراضيًا) أو بالتسلسل
- إذا لم يكن ضمن قائمة البثّ:
- تُطبّق آلية التوجيه العادية (أول ربط مطابق)
عزل الجلسات
يحافظ كل وكيل في مجموعة بثّ على فصلٍ كامل لما يلي:- مفاتيح الجلسات (
agent:alfred:whatsapp:group:120363...مقابلagent:baerbel:whatsapp:group:120363...) - سجلّ المحادثة (لا يرى الوكيل رسائل الوكلاء الآخرين)
- مساحة العمل (sandboxes منفصلة إذا كانت مهيّأة)
- الوصول إلى الأدوات (قوائم سماح/منع مختلفة)
- الذاكرة/السياق (ملفات IDENTITY.md و SOUL.md وغيرها منفصلة)
- مخزن سياق المجموعة (الرسائل الحديثة للمجموعة المستخدمة كسياق) يكون مشتركًا لكل نظير، لذا يرى جميع وكلاء البثّ السياق نفسه عند التفعيل
- شخصيات مختلفة
- وصولًا مختلفًا إلى الأدوات (مثل: للقراءة فقط مقابل قراءة/كتابة)
- نماذج مختلفة (مثل: opus مقابل sonnet)
- Skills مختلفة مُثبّتة
مثال: جلسات معزولة
في المجموعة[email protected] مع الوكلاء ["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 - تنسيق معرف الند صحيح (مثال:
[email protected]) - عدم وجود الوكلاء في قوائم المنع
استجابة وكيل واحد فقط
السبب: قد يكون مُعرّف النظير ضمنbindings وليس ضمن broadcast.
الحل: أضِف إلى تهيئة البثّ أو أزِل من الارتباطات.
مشكلات الأداء
إذا كان الأداء بطيئًا مع عدد كبير من الوكلاء:- تقليل عدد الوكلاء لكل مجموعة
- استخدام نماذج أخفّ (sonnet بدل opus)
- التحقق من زمن بدء تشغيل sandbox
أمثلة
المثال 1: فريق مراجعة الشيفرة
الردود:
- code-formatter: «تم إصلاح المسافات البادئة وإضافة تلميحات الأنواع»
- security-scanner: «⚠️ ثغرة حقن SQL في السطر 12»
- test-coverage: «نسبة التغطية 45%، اختبارات حالات الخطأ مفقودة»
- docs-checker: «docstring مفقود للدالة
process_data»
المثال 2: دعم متعدد اللغات
مرجع API
مخطط التهيئة
الحقول
strategy(اختياري): كيفية معالجة الوكلاء"parallel"(افتراضي): يعالج جميع الوكلاء في الوقت نفسه"sequential": يعالج الوكلاء وفق ترتيب المصفوفة
[peerId]: JID لمجموعة WhatsApp، أو رقم E.164، أو مُعرّف نظير آخر- القيمة: مصفوفة من مُعرّفات الوكلاء الذين ينبغي أن يعالجوا الرسائل
القيود
- الحد الأقصى للوكلاء: لا يوجد حدّ صارم، لكن قد يكون 10+ وكلاء بطيئًا
- السياق المشترك: لا يرى الوكلاء ردود بعضهم البعض (حسب التصميم)
- ترتيب الرسائل: قد تصل الردود المتوازية بأي ترتيب
- حدود المعدّل: تُحتسب جميع الوكلاء ضمن حدود معدّل WhatsApp
تحسينات مستقبلية
ميزات مخطّط لها:- وضع السياق المشترك (يرى الوكلاء ردود بعضهم البعض)
- تنسيق الوكلاء (يمكن للوكلاء إرسال إشارات لبعضهم)
- اختيار ديناميكي للوكلاء (اختيار الوكلاء بناءً على محتوى الرسالة)
- أولويات الوكلاء (يردّ بعض الوكلاء قبل الآخرين)