5.17 频道路由

核心概念核心概念

频道与路由

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

关键术语

  • 频道（Channel）：whatsapp、telegram、discord、slack、signal、imessage、webchat
  • 账户ID（AccountId）：每个频道的账户实例（如果支持）
  • AgentId：独立的工作空间 + 会话存储（"大脑"）
  • 会话键（SessionKey）：用于存储上下文和控制并发的桶键

会话键形式（示例）

直接消息折叠到 agent 的主会话：

agent:<agentId>:<channel>:<accountId> (默认: agent:main:main)

群组和频道按频道保持隔离：

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

主题：

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

示例：

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

路由规则（如何选择 agent）

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

  1. 精确对等匹配（bindings 带有 peer.kind + peer.id）
  2. 公会匹配（Discord）通过 guildId
  3. 团队匹配（Slack）通过 teamId
  4. 账户匹配（频道上的 accountId）
  5. 频道匹配（该频道上的任何账户）
  6. 默认 agent（agents.list[].default，否则第一个列表条目，回退到 main）

匹配的 agent 决定使用哪个工作空间和会话存储。

广播组（运行多个 agent）

广播组允许您为同一对等方运行多个 agent，当 OpenClaw 通常会回复时（例如：在 WhatsApp 群组中，在提及/激活门控之后）。

配置：

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

参见：广播组。

配置概述

  • agents.list：命名的 agent 定义（工作空间、模型等）
  • bindings：将入站频道/账户/对等方映射到 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} 模板覆盖存储路径。

WebChat 行为

WebChat 附加到选定的 agent 并默认为 agent 的主会话。因此，WebChat 允许您在一个地方查看该 agent 的跨频道上下文。

回复上下文

入站回复包括：

  • ReplyToId、ReplyToBody 和 ReplyToSender（如果可用）
  • 引用上下文作为 [Replying to ...] 块附加到 Body。这在频道之间是一致的