Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
الحالة: تجريبي. أُضيف في 2026.1.9.
نظرة عامة
تتيح مجموعات البث لعدة وكلاء معالجة الرسالة نفسها والرد عليها في الوقت نفسه. يتيح لك هذا إنشاء فرق وكلاء متخصصة تعمل معا داخل مجموعة WhatsApp واحدة أو رسالة مباشرة واحدة، وكل ذلك باستخدام رقم هاتف واحد. النطاق الحالي: WhatsApp فقط (قناة الويب). تُقيَّم مجموعات البث بعد قوائم السماح للقنوات وقواعد تفعيل المجموعات. في مجموعات WhatsApp، يعني ذلك أن البث يحدث عندما كان OpenClaw سيرد عادة (على سبيل المثال: عند الإشارة، حسب إعدادات مجموعتك).حالات الاستخدام
1. فرق وكلاء متخصصة
1. فرق وكلاء متخصصة
انشر عدة وكلاء بمسؤوليات ذرية ومركزة:يعالج كل وكيل الرسالة نفسها ويقدم منظوره المتخصص.
2. دعم متعدد اللغات
2. دعم متعدد اللغات
3. سير عمل ضمان الجودة
3. سير عمل ضمان الجودة
4. أتمتة المهام
4. أتمتة المهام
الإعدادات
الإعداد الأساسي
أضف قسما عالي المستوى باسمbroadcast (بجوار bindings). المفاتيح هي معرفات أقران WhatsApp:
- محادثات المجموعات: JID المجموعة (مثال:
120363403215116621@g.us) - الرسائل المباشرة: رقم هاتف بصيغة E.164 (مثال:
+15551234567)
استراتيجية المعالجة
تحكم في كيفية معالجة الوكلاء للرسائل:- parallel (الافتراضي)
- sequential
يعالج جميع الوكلاء في الوقت نفسه:
مثال كامل
كيف يعمل
تدفق الرسائل
إذا كان ضمن قائمة البث
- يعالج جميع الوكلاء المدرجين الرسالة.
- يمتلك كل وكيل مفتاح جلسة خاصا به وسياقا معزولا.
- يعالج الوكلاء بالتوازي (الافتراضي) أو بالتتابع.
لا تتجاوز مجموعات البث قوائم السماح للقنوات أو قواعد تفعيل المجموعات (الإشارات/الأوامر/إلخ). إنها تغير فقط أي الوكلاء يعملون عندما تكون الرسالة مؤهلة للمعالجة.
عزل الجلسات
يحافظ كل وكيل في مجموعة بث على ما يلي بشكل منفصل تماما:- مفاتيح الجلسات (
agent:alfred:whatsapp:group:120363...مقابلagent:baerbel:whatsapp:group:120363...) - سجل المحادثة (لا يرى الوكيل رسائل الوكلاء الآخرين)
- مساحة العمل (صناديق عزل منفصلة إذا تم إعدادها)
- الوصول إلى الأدوات (قوائم سماح/منع مختلفة)
- الذاكرة/السياق (ملفات IDENTITY.md وSOUL.md منفصلة، إلخ)
- مخزن سياق المجموعة (رسائل المجموعة الحديثة المستخدمة للسياق) مشترك لكل قرين، لذلك يرى جميع وكلاء البث السياق نفسه عند تشغيلهم
- شخصيات مختلفة
- وصول مختلف إلى الأدوات (مثلا، قراءة فقط مقابل قراءة وكتابة)
- نماذج مختلفة (مثلا، opus مقابل sonnet)
- Skills مختلفة مثبتة
مثال: جلسات معزولة
في المجموعة120363403215116621@g.us مع الوكلاء ["alfred", "baerbel"]:
- سياق Alfred
- سياق Bärbel
أفضل الممارسات
1. أبق الوكلاء مركزين
1. أبق الوكلاء مركزين
صمم كل وكيل بمسؤولية واحدة واضحة:✅ جيد: لكل وكيل مهمة واحدة. ❌ سيئ: وكيل عام واحد باسم “dev-helper”.
2. استخدم أسماء وصفية
2. استخدم أسماء وصفية
اجعل وظيفة كل وكيل واضحة:
3. اضبط وصولا مختلفا للأدوات
3. اضبط وصولا مختلفا للأدوات
امنح الوكلاء الأدوات التي يحتاجونها فقط:
reviewer للقراءة فقط. يستطيع fixer القراءة والكتابة.4. راقب الأداء
4. راقب الأداء
عند وجود عدد كبير من الوكلاء، ضع في اعتبارك:
- استخدام
"strategy": "parallel"(الافتراضي) للسرعة - حصر مجموعات البث في 5-10 وكلاء
- استخدام نماذج أسرع للوكلاء الأبسط
5. تعامل مع الإخفاقات بسلاسة
5. تعامل مع الإخفاقات بسلاسة
يفشل الوكلاء بشكل مستقل. خطأ وكيل واحد لا يحظر الآخرين:
التوافق
المزودون
تعمل مجموعات البث حاليا مع:- ✅ WhatsApp (منفذ)
- 🚧 Telegram (مخطط له)
- 🚧 Discord (مخطط له)
- 🚧 Slack (مخطط له)
التوجيه
تعمل مجموعات البث إلى جانب التوجيه الحالي:GROUP_A: يرد alfred فقط (توجيه عادي).GROUP_B: يرد agent1 وagent2 (بث).
الأسبقية: يأخذ
broadcast الأولوية على bindings.استكشاف الأخطاء وإصلاحها
الوكلاء لا يردون
الوكلاء لا يردون
تحقق من:
- معرفات الوكلاء موجودة في
agents.list. - تنسيق معرف القرين صحيح (مثلا،
120363403215116621@g.us). - الوكلاء غير موجودين في قوائم المنع.
وكيل واحد فقط يرد
وكيل واحد فقط يرد
السبب: قد يكون معرف القرين موجودا في
bindings لكن ليس في broadcast.الإصلاح: أضفه إلى إعدادات البث أو أزله من الربط.مشكلات الأداء
مشكلات الأداء
إذا كان بطيئا مع عدد كبير من الوكلاء:
- قلل عدد الوكلاء لكل مجموعة.
- استخدم نماذج أخف (sonnet بدلا من opus).
- تحقق من وقت بدء صندوق العزل.
أمثلة
مثال 1: فريق مراجعة الكود
مثال 1: فريق مراجعة الكود
- code-formatter: “تم إصلاح المسافات البادئة وإضافة تلميحات النوع”
- security-scanner: “⚠️ ثغرة حقن SQL في السطر 12”
- test-coverage: “التغطية 45%، وتوجد اختبارات مفقودة لحالات الخطأ”
- docs-checker: “سلسلة توثيق مفقودة للدالة
process_data”
مثال 2: دعم متعدد اللغات
مثال 2: دعم متعدد اللغات
مرجع API
مخطط الإعدادات
الحقول
كيفية معالجة الوكلاء. يشغّل
parallel جميع الوكلاء في الوقت نفسه؛ ويشغلهم sequential بترتيب المصفوفة.JID مجموعة WhatsApp، أو رقم E.164، أو معرف قرين آخر. القيمة هي مصفوفة معرفات الوكلاء التي يجب أن تعالج الرسائل.
القيود
- الحد الأقصى للوكلاء: لا يوجد حد صارم، لكن 10+ وكلاء قد يكونون بطيئين.
- السياق المشترك: لا يرى الوكلاء ردود بعضهم البعض (حسب التصميم).
- ترتيب الرسائل: قد تصل الردود المتوازية بأي ترتيب.
- حدود المعدل: يحتسب جميع الوكلاء ضمن حدود معدل WhatsApp.
التحسينات المستقبلية
الميزات المخطط لها:- وضع السياق المشترك (يرى الوكلاء ردود بعضهم البعض)
- تنسيق الوكلاء (يمكن للوكلاء إرسال إشارات لبعضهم البعض)
- اختيار الوكلاء ديناميكيا (اختيار الوكلاء بناء على محتوى الرسالة)
- أولويات الوكلاء (يرد بعض الوكلاء قبل الآخرين)