ブロードキャストグループ

原子的で集中的な責務を持つ複数のエージェントをデプロイします。

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": {
    "DEV_GROUP": ["formatter", "linter", "tester"]
  }
}

✅ 良い例: 各エージェントが 1 つの役割を持つ。❌ 悪い例: 汎用的な "dev-helper" エージェント 1 つ。

各エージェントが何をするのか明確にします。

{
  "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 エージェントに制限する
• より単純なエージェントには高速なモデルを使う

エージェントは独立して失敗します。1 つのエージェントのエラーが他をブロックすることはありません。

Message → [Agent A ✓, Agent B ✗ error, Agent C ✓]
Result: Agent A and C respond, Agent B logs error

確認:

1. エージェント ID が agents.list に存在する。
2. ピア ID の形式が正しい（例: [email protected]）。
3. エージェントが拒否リストに入っていない。

デバッグ:

tail -f ~/.openclaw/logs/gateway.log | grep broadcast

原因: ピア ID が bindings に含まれているが、broadcast には含まれていない可能性があります。

修正: ブロードキャスト設定に追加するか、バインディングから削除します。

エージェントが多くて遅い場合:

• グループあたりのエージェント数を減らします。
• 軽量なモデルを使います（opus ではなく sonnet）。
• サンドボックスの起動時間を確認します。

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

ユーザーが送信: コードスニペット。

応答:

• code-formatter: 「インデントを修正し、型ヒントを追加しました」
• security-scanner: 「⚠️ 12 行目に SQL インジェクション脆弱性があります」
• test-coverage: 「カバレッジは 45% で、エラーケースのテストが不足しています」
• docs-checker: 「関数 process_data の docstring がありません」

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