通道和路?

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

关键术语

  • 通道：whatsapp、telegram、discord、slack、signal、imessage、webchat?
  • AccountId：每个通道的账户实例（当支持时）?
  • AgentId：一个隔离的工作?+ 会话存储?大脑”）?
  • SessionKey：用于存储上下文和控制并发的桶键?

会话密钥形状（示例）

直接消息折叠到代理的**?*会话?

  • 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

路由规则（如何选择代理?

路由为每个入站消息选择一?代理*?

  1. 精确对等匹配（带?peer.kind + peer.id ?bindings）?
  2. **父对等匹?*（线程继承）?
  3. Guild + 角色匹配（Discord）通过 guildId + roles?
  4. Guild 匹配（Discord）通过 guildId?
  5. 团队匹配（Slack）通过 teamId?
  6. 账户匹配（通道上的 accountId）?
  7. 通道匹配（该通道上的任何账户，accountId: "*"）?
  8. 默认代理（agents.list[].default，否则第一个列表项，回退?main）?

当绑定包含多个匹配字段（peer、guildId、teamId、roles）时?*所有提供的字段必须匹配**才能应用该绑定?

匹配的代理决定使用哪个工作区和会话存储?

广播群组（运行多个代理）

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

配置?

{
  broadcast: {
    strategy: "parallel",
    "[email protected]": ["alfred", "baerbel"],
    "+15555550123": ["support", "logger"],
  },
}

参见：广播群组?

配置概述

  • agents.list：命名代理定义（工作区、模型等）?
  • bindings：将入站通道/账户/对等映射到代理?

示例?

{
  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 附加?选定的代?，默认使用代理的主会话。正因为如此，WebChat 让您在一个地方看到该代理的跨通道上下文?

回复上下?

入站回复包含?

  • ReplyToId、ReplyToBody ?ReplyToSender（如果可用）?
  • 引用上下文作?[Replying to ...] 块附加到 Body?

这在所有通道中是一致的?