渠道与路由

OpenClaw 将回复路由回消息来源渠道。模型不自主选择渠道；路由是确定性的，由宿主配置控制。

关键术语

• Channel（渠道）：telegram、whatsapp、discord、irc、googlechat、slack、signal、imessage、line，以及扩展渠道。webchat 是内部 WebChat UI 渠道，不是可配置的出站渠道
• AccountId：每个渠道的账号实例（在支持的情况下）
• 可选的渠道默认账号：channels.<channel>.defaultAccount 指定出站路径未指定 accountId 时使用哪个账号
  • 多账号设置中，配置两个或以上账号时请设置明确的默认账号（defaultAccount 或 accounts.default）；否则回退路由可能选择第一个规范化的账号 ID
• AgentId：独立的工作目录 + 会话存储（"大脑"）
• SessionKey：用于存储上下文和控制并发的桶键

会话密钥形式（示例）

私信折叠到 Agent 的主会话：

• agent:<agentId>:<mainKey>（默认：agent:main:main）

群组和频道按渠道隔离：

• 群组：agent:<agentId>:<channel>:group:<id>
• 频道/房间：agent:<agentId>:<channel>:channel:<id>

话题串：

• Slack/Discord 话题串在基础键后追加 :thread:<threadId>
• Telegram 论坛话题在群组键中嵌入 :topic:<topicId>

示例：

• agent:main:telegram:group:-1001234567890:topic:42
• agent:main:discord:channel:123456:thread:987654

主私信路由绑定

当 session.dmScope 为 main 时，私信可能共享一个主会话。 为防止非所有者私信覆盖会话的 lastRoute，当以下条件全部成立时 OpenClaw 会从 allowFrom 推断绑定所有者：

• allowFrom 有且仅有一个非通配符条目
• 该条目可以规范化为该渠道的具体发送者 ID
• 入站私信发送者与绑定所有者不匹配

在不匹配情况下，OpenClaw 仍记录入站会话元数据，但跳过更新主会话 lastRoute。

路由规则（如何选择 Agent）

路由为每条入站消息选择一个 Agent：

1. 精确 peer 匹配（bindings 中带 peer.kind + peer.id）
2. 父 peer 匹配（话题串继承）
3. Guild + 角色匹配（Discord）通过 guildId + roles
4. Guild 匹配（Discord）通过 guildId
5. 团队匹配（Slack）通过 teamId
6. 账号匹配（渠道上的 accountId）
7. 渠道匹配（该渠道上任意账号，accountId: "*"）
8. 默认 Agent（agents.list[].default，否则列表第一项，最后回退到 main）

当 binding 包含多个匹配字段（peer、guildId、teamId、roles）时，所有提供的字段必须全部匹配该 binding 才会生效。

匹配到的 Agent 决定使用哪个工作目录和会话存储。

广播组（运行多个 Agent）

广播组让你在 OpenClaw 正常回复时（例如：WhatsApp 群组中被提及/激活后）为同一 peer 运行多个 Agent。

配置：

{
  broadcast: {
    strategy: "parallel",
    "120363403215116621@g.us": ["alfred", "baerbel"],
    "+15555550123": ["support", "logger"],
  },
}

参见：广播组。

配置概览

• agents.list：命名 Agent 定义（工作目录、模型等）
• bindings：将入站渠道/账号/peer 映射到 Agent

示例：

{
  agents: {
    list: [{ id: "support", name: "Support", workspace: "~/.openclaw/workspace-support" }],
  },
  bindings: [
    { match: { channel: "slack", teamId: "T123" }, agentId: "support" },
    { match: { channel: "telegram", peer: { kind: "group", id: "-100123" } }, agentId: "support" },
  ],
}

会话存储

会话存储位于状态目录下（默认 ~/.openclaw）：

• ~/.openclaw/agents/<agentId>/sessions/sessions.json
• JSONL 记录文件与存储并列

你可以通过 session.store 和 {agentId} 模板覆盖存储路径。

Gateway 和 ACP 会话发现还会扫描默认 agents/ 根目录和模板化 session.store 根目录下磁盘支持的 Agent 存储。发现的存储必须在已解析的 Agent 根目录内，使用常规 sessions.json 文件；符号链接和根目录外路径会被忽略。

WebChat 行为

WebChat 附加到选定的 Agent并默认使用 Agent 的主会话。因此，WebChat 允许你在一个地方查看该 Agent 的跨渠道上下文。

回复上下文

入站回复包含（若可用）：

• ReplyToId、ReplyToBody 和 ReplyToSender
• 引用上下文以 [Replying to ...] 块的形式追加到 Body

这在各渠道之间保持一致。

小龙虾的消息路由机制确保每条消息都回到它的来源地——Telegram 进，Telegram 出，绝不串台。