多 Agent 路由设计：当不同渠道、不同用户需要匹配不同“大脑”-尧图网络科技

多 Agent 路由设计：当不同渠道、不同用户需要匹配不同“大脑”

- 1. 引言：为什么需要多 Agent 路由？
- 2. 核心概念：Agent、Account、Binding 三位一体
- 3. 路由匹配优先级：从最具体到最宽泛
- 4. 路由设计的工程实践
- - 4.1 按渠道拆分：WhatsApp 日常 + Telegram 深度工作
  - 4.2 同一渠道，将特定私信路由到专用 Agent
  - 4.3 绑定 WhatsApp 群组到家庭 Agent
- 5. 会话键（SessionKey）：路由如何决定上下文隔离
- 6. 多 Agent 路由 vs 并行专家通道
- 7. 一张图看懂多 Agent 路由设计
- 8. 结语

🌺The Begin🌺点点关注，收藏不迷路🌺

⬇ ⬇ 底部 ⬇ ⬇

1. 引言：为什么需要多 Agent 路由？

如果只是单用户、单场景，一个 Agent 就够了。但当 Agent 系统走向真实生产环境，很快会遇到两个现实问题：

同一台服务器要服务多个用户——张三用 WhatsApp，李四用 Telegram，他们不希望自己的对话上下文互相串扰
同一个人在不同场景下需要不同“人格”的 Agent——工作时用编程 Agent，回家后用家庭 Agent

更深层的原因是：在 Agent 系统中，Agent ID 直接决定了工作区、凭证、会话存储和个性规则。路由选错了 Agent，等于用了别人的“大脑”。

一句话定位：OpenClaw 的多 Agent 路由通过“绑定（Binding）”机制，将特定渠道的账号或会话精确映射到对应的 Agent ID，采用“最具体优先”的确定性匹配策略，确保每条入站消息都能找到正确的智能体。

2. 核心概念：Agent、Account、Binding 三位一体

在 OpenClaw 中，设计多 Agent 路由首先要理解三个基本概念：

概念	含义	示例
AgentId	一个完整的“大脑”——拥有独立的工作区、凭证、会话存储和人格规则	`coding`、`family`、`main`
AccountId	一个渠道账号实例	WhatsApp 的`personal`、`biz`；Telegram 的`coding_bot`、`social_bot`
Binding	将入站消息按 (channel, accountId, peer) 路由到某个 agentId 的规则	`{ channel: "whatsapp", accountId: "personal", agentId: "main" }`

关键设计原则：agentId 是隔离边界。每个 agentId 拥有自己的~/.openclaw/agents/<agentId>/目录，包含独立的agent配置目录和sessions会话存储。

路由时绑定是确定性的，并且最具体者优先。

3. 路由匹配优先级：从最具体到最宽泛

OpenClaw 为每条入站消息按以下优先级选择 Agent：

优先级	匹配类型	说明
1	精确 peer 匹配	精确匹配 DM/群组/频道 ID
2	父 peer 匹配	线程继承（如 Discord 线程的父消息）
3	guildId + roles	Discord 服务器 + 角色匹配
4	guildId	Discord 服务器匹配
5	teamId	Slack 工作区匹配
6	accountId	按渠道账号回退
7	channel 级匹配	`accountId: "*"`匹配该渠道任意账号
8	默认 Agent	`agents.list[].default`，否则第一个列表条目，最终回退为`main`

核心规则：当一个 binding 包含多个匹配字段时（如 peer + guildId），所有提供字段都必须满足（AND 语义）。同层级匹配冲突时，配置顺序中的第一个胜出。

4. 路由设计的工程实践

4.1 按渠道拆分：WhatsApp 日常 + Telegram 深度工作

{ agents: { list: [ { id: "fast", workspace: "~/.openclaw/workspace-fast" }, { id: "opus", workspace: "~/.openclaw/workspace-opus" }, ], }, bindings: [ { agentId: "fast", match: { channel: "whatsapp", accountId: "*" } }, { agentId: "opus", match: { channel: "telegram", accountId: "*" } }, ], }

这样每个渠道的账号被绑定到不同 Agent，实现渠道级的上下文隔离。

4.2 同一渠道，将特定私信路由到专用 Agent

同一 WhatsApp 账号下，不同的私信发送者可以路由到不同 Agent。通过peer.kind: "direct"匹配发送者的 E.164 格式号码：

{ bindings: [ { agentId: "alex", match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230001" } }, }, { agentId: "mia", match: { channel: "whatsapp", peer: { kind: "direct", id: "+15551230002" } }, }, ], }

peer 匹配永远优先于 channel 级别的绑定，因此可以实现“同一渠道、不同私信走不同 Agent”的精细控制。

4.3 绑定 WhatsApp 群组到家庭 Agent

将单个群组绑定到专用 Agent，配合提及门控和更严格的工具策略：

{ bindings: [ { agentId: "family", match: { channel: "whatsapp", peer: { kind: "group", id: "1234567890" } }, }, ], }

这样该群组的消息只由familyAgent 处理，其他消息继续走默认 Agent。

5. 会话键（SessionKey）：路由如何决定上下文隔离

路由选中的 Agent 决定了工作区和会话存储的位置。不同场景的会话键形态如下：

场景	SessionKey 格式	示例
私信（默认）	`agent:<agentId>:<mainKey>`	`agent:main:main`
群组	`agent:<agentId>:<channel>:group:<id>`	`agent:main:telegram:group:-1001234567890`
频道/房间	`agent:<agentId>:<channel>:channel:<id>`	`agent:main:discord:channel:123456`
线程	附加`:thread:<threadId>`	`agent:main:discord:channel:123456:thread:987654`
Telegram 话题	嵌入`:topic:<topicId>`	`agent:main:telegram:group:-1001234567890:topic:42`