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

نمای کلی

گروه‌های پخش، چند عامل را روی یک پیام ورودی یکسان اجرا می‌کنند. هر عامل پیام را در نشست مجزای خود پردازش می‌کند و پاسخ خودش را می‌فرستد؛ بنابراین یک شمارهٔ 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 محاسبه می‌شود.

مرتبط

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