多代理路由配置指南

本文介绍 OpenClaw 的多代理路由功能。

路由基础

什么是多代理路由

多代理路由允许将不同来源的请求路由到不同的 AI 代理：

• 按渠道隔离
• 按用户隔离
• 按内容类型隔离

基本配置

{
  "routing": {
    "default": "default-agent",
    "rules": []
  }
}

路由规则

按渠道路由

{
  "routing": {
    "rules": [
      {
        "condition": {
          "channel": "whatsapp"
        },
        "agent": "whatsapp-agent"
      },
      {
        "condition": {
          "channel": "telegram"
        },
        "agent": "telegram-agent"
      },
      {
        "condition": {
          "channel": "discord"
        },
        "agent": "discord-agent"
      }
    ]
  }
}

按用户路由

{
  "routing": {
    "rules": [
      {
        "condition": {
          "user_id": "admin123"
        },
        "agent": "admin-agent"
      },
      {
        "condition": {
          "user_role": "premium"
        },
        "agent": "premium-agent"
      }
    ]
  }
}

按内容路由

{
  "routing": {
    "rules": [
      {
        "condition": {
          "contains": ["代码", "编程", "debug"]
        },
        "agent": "developer-agent"
      },
      {
        "condition": {
          "contains": ["翻译", "英文", "日语"]
        },
        "agent": "translator-agent"
      },
      {
        "condition": {
          "contains": ["数据分析", "报表", "统计"]
        },
        "agent": "data-agent"
      }
    ]
  }
}

工作区隔离

创建工作区

{
  "workspaces": {
    "engineering": {
      "agents": ["dev-agent-1", "dev-agent-2"],
      "channels": ["engineering-telegram", "engineering-discord"],
      "members": ["user1", "user2"]
    },
    "support": {
      "agents": ["support-agent"],
      "channels": ["support-whatsapp", "support-email"],
      "members": ["support1", "support2"]
    }
  }
}

工作区路由

{
  "routing": {
    "rules": [
      {
        "condition": {
          "workspace": "engineering"
        },
        "agent": "engineering-team-agent"
      },
      {
        "condition": {
          "workspace": "support"
        },
        "agent": "support-team-agent"
      }
    ]
  }
}

代理配置

代理定义

{
  "agents": {
    "default-agent": {
      "model": "claude-3-5-sonnet",
      "temperature": 0.7,
      "max_tokens": 4096,
      "tools": ["browser", "exec", "canvas"]
    },
    "developer-agent": {
      "model": "gpt-4o",
      "temperature": 0.3,
      "max_tokens": 8192,
      "tools": ["browser", "exec", "code_analysis"]
    }
  }
}

代理池

{
  "agent_pools": {
    "general": {
      "agents": ["agent-1", "agent-2", "agent-3"],
      "strategy": "round_robin"
    },
    "priority": {
      "agents": ["premium-1", "premium-2"],
      "strategy": "least_loaded"
    }
  }
}

动态路由

负载均衡

async def route_to_agent(context):
    # 检查各代理负载
    loads = await get_agent_loads()
    
    # 选择负载最低的代理
    selected = min(loads, key=lambda x: x.load)
    return selected.agent_id

智能路由

async def smart_route(message):
    # 分析消息内容
    intent = await analyze_intent(message.text)
    
    # 根据意图选择代理
    agent_map = {
        "technical": "developer-agent",
        "general": "default-agent",
        "urgent": "priority-agent"
    }
    
    return agent_map.get(intent, "default-agent")

场景示例

场景一：客服系统

用户 → WhatsApp → 客服代理
用户 → Telegram → 技术支持代理
用户 → Email → 邮件处理代理

场景二：多团队协作

工程团队 → engineering-channel → 开发代理
产品团队 → product-channel → 产品代理
运营团队 → operations-channel → 运营代理

场景三：VIP 服务

VIP 用户 → premium-agent（优先响应）
普通用户 → default-agent（正常响应）

下一步

• Gateway 架构
• 核心能力总览
• 安全配置