گروه‌های پخش همگانی

نمای کلی

گروه‌های پخش، چندین عامل را برای یک پیام ورودی یکسان اجرا می‌کنند. هر عامل پیام را در نشست ایزولهٔ خودش پردازش می‌کند و پاسخ خودش را می‌فرستد؛ بنابراین یک شمارهٔ WhatsApp می‌تواند در یک گفت‌وگوی گروهی یا پیام مستقیم، میزبان تیمی از عامل‌های تخصصی باشد.

گروه‌های پخش پس از فهرست‌های مجاز کانال و قواعد فعال‌سازی گروه ارزیابی می‌شوند. در گروه‌های WhatsApp، پخش زمانی انجام می‌شود که OpenClaw در حالت عادی پاسخ می‌داد (برای مثال: هنگام منشن‌شدن، بسته به تنظیمات گروه). این گروه‌ها فقط عامل‌هایی را که اجرا می‌شوند تغییر می‌دهند و هرگز تعیین نمی‌کنند که آیا یک پیام واجد شرایط پردازش است یا نه.

لاین زندهٔ QA برای WhatsApp شامل whatsapp-broadcast-group-fanout است که تأیید می‌کند یک پیام گروهی منشن‌دار می‌تواند پاسخ‌های قابل‌مشاهده و متمایزی از دو عامل پیکربندی‌شده ایجاد کند.

پیکربندی

راه‌اندازی پایه

یک بخش سطح‌بالای broadcast (در کنار bindings) اضافه کنید. کلیدها شناسه‌های همتای WhatsApp و مقادیر آرایه‌هایی از شناسه‌های عامل هستند:

• گفت‌وگوهای گروهی: JID گروه (برای مثال 120363403215116621@g.us)
• پیام‌های مستقیم: شماره‌تلفن E.164 فرستنده (برای مثال +15551234567)

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

نتیجه: هر زمان OpenClaw در این گفت‌وگو پاسخ دهد، هر سه عامل را اجرا می‌کند.

هر شناسهٔ عامل فهرست‌شده باید در agents.entries وجود داشته باشد: اعتبارسنجی پیکربندی شناسه‌های ناشناخته را گزارش می‌کند و زمان اجرا با هشدار Broadcast agent <id> not found in agents.entries; 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"]:

نشست: agent:alfred:whatsapp:group:120363403215116621@g.usتاریخچه: [پیام کاربر، پاسخ‌های قبلی alfred]فضای کاری: ~/openclaw-alfred/ابزارها: خواندن، نوشتن، اجرا

نشست: agent:baerbel:whatsapp:group:120363403215116621@g.usتاریخچه: [پیام کاربر، پاسخ‌های قبلی baerbel]فضای کاری: ~/openclaw-baerbel/ابزارها: فقط خواندن

موارد استفاده

• تیم‌های عامل تخصصی: یک گروه توسعه که در آن 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 محاسبه می‌شود.

مرتبط

• مسیریابی کانال
• گروه‌ها
• ابزارهای سندباکس چندعاملی
• جفت‌سازی
• مدیریت نشست