مجموعات البث

نظرة عامة

تُشغّل مجموعات البث وكلاء متعددين لمعالجة الرسالة الواردة نفسها. يعالج كل وكيل الرسالة في جلسته المعزولة وينشر رده الخاص، بحيث يمكن لرقم WhatsApp واحد استضافة فريق من الوكلاء المتخصصين في محادثة جماعية واحدة أو رسالة خاصة.

تُقيَّم مجموعات البث بعد قوائم السماح الخاصة بالقناة وقواعد تفعيل المجموعة. في مجموعات WhatsApp، يحدث البث عندما يكون من المعتاد أن يرد OpenClaw (على سبيل المثال: عند الإشارة إليه، وفقًا لإعدادات مجموعتك). وهي لا تغيّر سوى الوكلاء الذين يعملون، ولا تغيّر مطلقًا ما إذا كانت الرسالة مؤهلة للمعالجة.

يتضمن مسار ضمان الجودة المباشر لـ WhatsApp الاختبار whatsapp-broadcast-group-fanout، الذي يتحقق من أن رسالة واحدة في مجموعة تتضمن إشارة يمكن أن تنتج ردودًا مرئية ومختلفة من وكيلين مهيأين.

الإعداد

الإعداد الأساسي

أضف قسم broadcast في المستوى الأعلى (بجوار bindings). المفاتيح هي معرّفات نظراء WhatsApp، والقيم هي مصفوفات من معرّفات الوكلاء:

• المحادثات الجماعية: معرّف JID للمجموعة (مثل 120363403215116621@g.us)
• الرسائل الخاصة: رقم هاتف المرسل بتنسيق E.164 (مثل +15551234567)

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

النتيجة: عندما يرد OpenClaw في هذه المحادثة، فإنه يشغّل الوكلاء الثلاثة جميعًا.

يجب أن يكون كل معرّف وكيل مُدرج موجودًا في agents.list: يُبلغ التحقق من صحة الإعداد عن المعرّفات غير المعروفة، ويتخطاها وقت التشغيل مع التحذير Broadcast agent <id> not found in agents.list; skipping.

استراتيجية المعالجة

يحدد broadcast.strategy كيفية معالجة الوكلاء للرسالة:

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

مثال كامل

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

آلية العمل

تدفق الرسالة

عزل الجلسات

يحتفظ كل وكيل في مجموعة بث بما يلي بصورة منفصلة تمامًا:

• مفاتيح الجلسات (agent:alfred:whatsapp:group:120363... مقابل agent:baerbel:whatsapp:group:120363...)
• سجل المحادثة (لا يرى الوكيل ردود الوكلاء الآخرين)
• مساحة العمل (بيئات معزولة منفصلة إذا كانت مهيأة)
• الوصول إلى الأدوات (قوائم سماح/رفض مختلفة)
• الذاكرة/السياق (ملفات IDENTITY.md وSOUL.md منفصلة، وما إلى ذلك)

يوجد استثناء واحد مشترك عمدًا: مخزن سياق المجموعة المؤقت (رسائل المجموعة الأخيرة المستخدمة للسياق) مشترك لكل نظير، بحيث يرى جميع وكلاء البث السياق نفسه عند تشغيلهم. ويُمسح مرة واحدة بعد اكتمال التوزيع.

يتيح ذلك لكل وكيل امتلاك شخصيات ونماذج وSkills وإمكانية وصول إلى الأدوات مختلفة (مثل القراءة فقط مقابل القراءة والكتابة).

مثال: جلسات معزولة

في المجموعة 120363403215116621@g.us مع الوكيلين ["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

حالات الاستخدام

• فرق الوكلاء المتخصصين: مجموعة تطوير يجيب فيها كل من code-reviewer وsecurity-auditor وtest-generator وdocs-checker عن الرسالة نفسها من منظوره الخاص.
• دعم متعدد اللغات: محادثة دعم واحدة يستجيب فيها support-en وsupport-de وsupport-es بلغاتهم.
• ضمان الجودة: يجيب support-agent بينما يراجع qa-agent ولا يستجيب إلا عندما يعثر على مشكلات.
• أتمتة المهام: يستهلك كل من task-tracker وtime-logger وreport-generator تحديث الحالة نفسه.

أفضل الممارسات

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

التوافق

المزوّدون

تُنفَّذ مجموعات البث حاليًا لـ WhatsApp (قناة الويب) فقط. وتتجاهل القنوات الأخرى إعداد broadcast.

التوجيه

تعمل مجموعات البث إلى جانب التوجيه الحالي:

{  "bindings": [    {      "match": { "channel": "whatsapp", "peer": { "kind": "group", "id": "GROUP_A" } },      "agentId": "alfred"    }  ],  "broadcast": {    "GROUP_B": ["agent1", "agent2"]  }}

• GROUP_A: يستجيب alfred فقط (التوجيه العادي).
• GROUP_B: يستجيب agent1 وagent2 (البث).

استكشاف الأخطاء وإصلاحها

openclaw logs --follow | grep -i broadcast

أمثلة

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

مرجع API

مخطط الإعداد

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

الحقول

القيود

1. الحد الأقصى للوكلاء: لا يوجد حد صارم، لكن استخدام عدد كبير من الوكلاء (10 فأكثر) قد يكون بطيئًا.
2. السياق المشترك: لا يرى الوكلاء ردود بعضهم بعضًا (حسب التصميم).
3. ترتيب الرسائل: قد تصل الردود المتوازية بأي ترتيب.
4. حدود المعدل: تصدر جميع الردود من حساب WhatsApp واحد، لذا يُحتسب رد كل وكيل ضمن حدود معدل WhatsApp نفسها.

ذو صلة

• توجيه القنوات
• المجموعات
• أدوات وضع الحماية متعدد الوكلاء
• الإقران
• إدارة الجلسات