广播组

部署多个职责原子化且聚焦的智能体：

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

✅ 好： 每个智能体只有一项工作。❌ 不好： 一个通用的 “dev-helper” 智能体。

清楚说明每个智能体的作用：

{
  "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"（默认）以提升速度
• 将 broadcast groups 限制为 5-10 个智能体
• 为更简单的智能体使用更快的模型

智能体会独立失败。一个智能体的错误不会阻塞其他智能体：

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 中。

修复： 添加到 broadcast 配置，或从 bindings 中移除。

如果多个智能体导致速度变慢：

• 减少每个群组的智能体数量。
• 使用更轻量的模型（使用 sonnet 而不是 opus）。
• 检查沙箱启动时间。

{
  "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 缺少文档字符串”

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