مجموعات البث

نظرة عامة

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

النطاق الحالي: WhatsApp فقط (قناة الويب).

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

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

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

Group: "Development Team"Agents:  - CodeReviewer (reviews code snippets)  - DocumentationBot (generates docs)  - SecurityAuditor (checks for vulnerabilities)  - TestGenerator (suggests test cases)

Group: "International Support"Agents:  - Agent_EN (responds in English)  - Agent_DE (responds in German)  - Agent_ES (responds in Spanish)

Group: "Customer Support"Agents:  - SupportAgent (provides answer)  - QAAgent (reviews quality, only responds if issues found)

Group: "Project Management"Agents:  - TaskTracker (updates task database)  - TimeLogger (logs time spent)  - ReportGenerator (creates summaries)

التكوين

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

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

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

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

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

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

تحكم في كيفية معالجة الوكلاء للرسائل:

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

{  "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 وغيرها منفصلة)
• مخزن سياق المجموعة المؤقت (رسائل المجموعة الحديثة المستخدمة للسياق) مشترك لكل نظير، لذلك يرى جميع وكلاء البث السياق نفسه عند تشغيلهم

يتيح ذلك لكل وكيل أن يمتلك:

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

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

في المجموعة 120363403215116621@g.us مع الوكلاء ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:120363403215116621@g.usHistory: [user message, alfred's previous responses]Workspace: /Users/user/openclaw-alfred/Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:120363403215116621@g.usHistory: [user message, baerbel's previous responses]Workspace: /Users/user/openclaw-baerbel/Tools: read only

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

{  "broadcast": {    "DEV_GROUP": ["formatter", "linter", "tester"]  }}

{  "agents": {    "security-scanner": { "name": "Security Scanner" },    "code-formatter": { "name": "Code Formatter" },    "test-generator": { "name": "Test Generator" }  }}

{  "agents": {    "reviewer": {      "tools": { "allow": ["read", "exec"] }    },    "fixer": {      "tools": { "allow": ["read", "write", "edit", "exec"] }    }  }}

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]Result: Agent A and C respond, Agent B logs error

التوافق

المزوّدون

تعمل مجموعات البث حاليا مع:

• ✅ WhatsApp (منفذ)
• 🚧 Telegram (مخطط)
• 🚧 Discord (مخطط)
• 🚧 Slack (مخطط)

التوجيه

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

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

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

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

tail -f ~/.openclaw/logs/gateway.log | grep 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.

التحسينات المستقبلية

الميزات المخطط لها:

• [ ] وضع السياق المشترك (يرى الوكلاء ردود بعضهم البعض)
• [ ] تنسيق الوكلاء (يمكن للوكلاء إرسال إشارات إلى بعضهم البعض)
• [ ] الاختيار الديناميكي للوكلاء (اختيار الوكلاء بناءً على محتوى الرسالة)
• [ ] أولويات الوكلاء (يرد بعض الوكلاء قبل غيرهم)

ذات صلة

• توجيه القنوات
• المجموعات
• أدوات بيئة الاختبار المعزولة متعددة الوكلاء
• الإقران
• إدارة الجلسات