گروه‌های پخش

نمای کلی

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

دامنه فعلی: فقط WhatsApp (کانال وب).

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

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

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

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...)
• تاریخچه مکالمه (عامل پیام‌های عامل‌های دیگر را نمی‌بیند)
• Workspace (در صورت پیکربندی، sandboxهای جداگانه)
• دسترسی به ابزار (فهرست‌های allow/deny متفاوت)
• حافظه/زمینه (IDENTITY.md، SOUL.md و غیره جداگانه)
• بافر زمینه گروه (پیام‌های اخیر گروه که برای زمینه استفاده می‌شوند) برای هر همتا مشترک است، بنابراین همه عامل‌های پخش هنگام trigger شدن زمینه یکسانی را می‌بینند

این به هر عامل امکان می‌دهد موارد زیر را داشته باشد:

• شخصیت‌های متفاوت
• دسترسی متفاوت به ابزار (مثلاً فقط‌خواندنی در برابر خواندن-نوشتن)
• مدل‌های متفاوت (مثلاً 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. حداکثر عامل‌ها: محدودیت سختی وجود ندارد، اما ۱۰ عامل یا بیشتر ممکن است کند باشد.
2. زمینه مشترک: عامل‌ها پاسخ‌های یکدیگر را نمی‌بینند (طبق طراحی).
3. ترتیب پیام‌ها: پاسخ‌های موازی ممکن است با هر ترتیبی برسند.
4. محدودیت‌های نرخ: همه عامل‌ها در محدودیت‌های نرخ WhatsApp محاسبه می‌شوند.

بهبودهای آینده

قابلیت‌های برنامه‌ریزی‌شده:

• [ ] حالت زمینه مشترک (عامل‌ها پاسخ‌های یکدیگر را می‌بینند)
• [ ] هماهنگی عامل‌ها (عامل‌ها می‌توانند به یکدیگر سیگنال بدهند)
• [ ] انتخاب پویای عامل (عامل‌ها را بر اساس محتوای پیام انتخاب کنید)
• [ ] اولویت‌های عامل (برخی عامل‌ها پیش از دیگران پاسخ می‌دهند)

مرتبط

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