گروه‌های پخش

# نمای کلی

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

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

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

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

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 گروه (مثلاً [email protected])
• پیام‌های مستقیم: شماره تلفن E.164 (مثلاً +15551234567)

{
  "broadcast": {
    "[email protected]": ["alfred", "baerbel", "assistant3"]
  }
}

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

# راهبرد پردازش

نحوه پردازش پیام‌ها توسط عامل‌ها را کنترل کنید:

{
  "broadcast": {
    "strategy": "parallel",
    "[email protected]": ["alfred", "baerbel"]
  }
}

{
  "broadcast": {
    "strategy": "sequential",
    "[email protected]": ["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",
    "[email protected]": ["code-reviewer", "security-auditor", "docs-generator"],
    "[email protected]": ["support-en", "support-de"],
    "+15555550123": ["assistant", "logger"]
  }
}

# نحوه کارکرد

# جریان پیام

# جداسازی جلسه

هر عامل در یک گروه پخش موارد زیر را کاملاً جداگانه نگه می‌دارد:

• کلیدهای جلسه (agent:alfred:whatsapp:group:120363... در برابر agent:baerbel:whatsapp:group:120363...)
• تاریخچه گفتگو (عامل پیام‌های عامل‌های دیگر را نمی‌بیند)
• فضای کاری (sandboxهای جداگانه در صورت پیکربندی)
• دسترسی ابزار (فهرست‌های مجاز/ممنوع متفاوت)
• حافظه/زمینه (IDENTITY.md، SOUL.md و غیره جداگانه)
• بافر زمینه گروه (پیام‌های اخیر گروه که برای زمینه استفاده می‌شوند) برای هر همتا مشترک است، بنابراین همه عامل‌های پخش هنگام فعال‌شدن همان زمینه را می‌بینند

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

• شخصیت‌های متفاوت
• دسترسی ابزار متفاوت (مثلاً فقط‌خواندنی در برابر خواندنی-نوشتنی)
• مدل‌های متفاوت (مثلاً opus در برابر sonnet)
• Skills نصب‌شده متفاوت

# مثال: جلسه‌های جداشده

در گروه [email protected] با عامل‌های ["alfred", "baerbel"]:

Session: agent:alfred:whatsapp:group:[email protected]
History: [user message, alfred's previous responses]
Workspace: /Users/user/openclaw-alfred/
Tools: read, write, exec

Session: agent:baerbel:whatsapp:group:[email protected]
History: [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",
    "[email protected]": [
      "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 حساب می‌شوند.

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

ویژگی‌های برنامه‌ریزی‌شده:

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

# مرتبط

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