الانتقال إلى المحتوى الرئيسي
الحالة: تجريبي. أضيف في 2026.1.9.

​
نظرة عامة

تتيح مجموعات البث لعدة وكلاء معالجة الرسالة نفسها والرد عليها في الوقت نفسه. يتيح لك ذلك إنشاء فرق وكلاء متخصصة تعمل معا في مجموعة 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"]
  }
}

​
مثال كامل

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

​
كيفية عمله

​
تدفق الرسائل

1

وصول رسالة واردة

تصل رسالة من مجموعة WhatsApp أو رسالة مباشرة.
2

التوجيه والقبول

يطبق OpenClaw قوائم السماح الخاصة بالقناة، وقواعد تفعيل المجموعات، وملكية ارتباط ACP المكوّنة.
3

التحقق من البث

إذا لم يكن هناك ارتباط ACP مكوّن يملك المسار، يتحقق OpenClaw مما إذا كان معرّف النظير موجودا في broadcast.
4

إذا انطبق البث

  • يعالج جميع الوكلاء المدرجين الرسالة.
  • لكل وكيل مفتاح جلسة خاص به وسياق معزول.
  • يعالج الوكلاء بالتوازي (افتراضيا) أو بالتتابع.
5

إذا لم ينطبق البث

يرسل OpenClaw المسار العادي أو مسار جلسة ACP المكوّن الذي تم اختياره أثناء التوجيه.
لا تتجاوز مجموعات البث قوائم السماح الخاصة بالقناة أو قواعد تفعيل المجموعات (الإشارات/الأوامر/وما إلى ذلك). إنها لا تغيّر إلا أي الوكلاء يعملون عندما تكون الرسالة مؤهلة للمعالجة.

​
عزل الجلسات

يحافظ كل وكيل في مجموعة بث على ما يلي بشكل منفصل تماما:
  • مفاتيح الجلسة (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.us
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

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

صمم كل وكيل بمسؤولية واحدة واضحة:
{
  "broadcast": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}
✅ جيد: لكل وكيل مهمة واحدة. ❌ سيئ: وكيل عام واحد باسم “dev-helper”.
اجعل ما يفعله كل وكيل واضحا:
{
  "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"] }
    }
  }
}
reviewer مخصص للقراءة فقط. يمكن لـ fixer القراءة والكتابة.
مع وجود عدد كبير من الوكلاء، ضع في اعتبارك:
  • استخدام "strategy": "parallel" (الافتراضي) للسرعة
  • حصر مجموعات البث في 5-10 وكلاء
  • استخدام نماذج أسرع للوكلاء الأبسط
يفشل الوكلاء بشكل مستقل. لا يمنع خطأ وكيل واحد الآخرين:
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 (بث).
الأسبقية: يأخذ broadcast الأولوية على ارتباطات المسارات العادية. ارتباطات ACP المكوّنة (bindings[].type="acp") حصرية: عند تطابق أحدها، يرسل OpenClaw إلى جلسة ACP المكوّنة بدلا من بث التوسيع.

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

تحقق من:
  1. وجود معرّفات الوكلاء في agents.list.
  2. صحة تنسيق معرّف النظير (مثال: 120363403215116621@g.us).
  3. عدم وجود الوكلاء في قوائم الرفض.
تصحيح الأخطاء:
tail -f ~/.openclaw/logs/gateway.log | grep broadcast
السبب: قد يكون معرّف النظير موجودا في ارتباطات المسارات العادية ولكن ليس في broadcast، أو قد يطابق ارتباط ACP مكوّنا حصريا.الإصلاح: أضف النظراء المرتبطين بمسارات عادية إلى تكوين البث، أو أزل/غيّر ارتباط ACP المكوّن إذا كان بث التوسيع مطلوبا.
إذا كان الأداء بطيئا مع عدد كبير من الوكلاء:
  • قلل عدد الوكلاء لكل مجموعة.
  • استخدم نماذج أخف (sonnet بدلا من opus).
  • تحقق من وقت بدء بيئة العزل.

​
أمثلة

{
  "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"] } }
    ]
  }
}
يرسل المستخدم: مقتطف كود.الردود:
  • code-formatter: “تم إصلاح الإزاحة وإضافة تلميحات الأنواع”
  • security-scanner: “⚠️ ثغرة حقن SQL في السطر 12”
  • test-coverage: “التغطية 45%، وتوجد اختبارات مفقودة لحالات الخطأ”
  • docs-checker: “سلسلة التوثيق مفقودة للدالة process_data”
{
  "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[];
  };
}

​
الحقول

​
strategy
"parallel" | "sequential"
افتراضي:"\"parallel\""
كيفية معالجة الوكلاء. يشغّل parallel كل الوكلاء في الوقت نفسه؛ ويشغّلهم sequential بترتيبهم في المصفوفة.
​
[peerId]
string[]
JID لمجموعة WhatsApp، أو رقم E.164، أو معرف نظير آخر. القيمة هي مصفوفة معرفات الوكلاء التي يجب أن تعالج الرسائل.

​
القيود

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

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

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

​
ذات صلة