OpenClaw 🦞

Channel Routing

Channels & routing

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

关键术语

  • Channel：whatsapp、telegram、discord、slack、signal、imessage、webchat。
  • AccountId：每个渠道的账户实例（支持时）。
  • 可选渠道默认账户：channels.<channel>.defaultAccount 选择当出站路径未指定 accountId 时使用哪个账户。
  • AgentId：隔离的工作区 + 会话存储（"brain"）。
  • SessionKey：用于存储上下文和控制并发的 bucket 键。

会话键形状（示例）

私信折叠到代理的main会话：

  • 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

主 DM 路由固定

当 session.dmScope 为 main 时，私信可能共享一个主会话。 为了防止会话的 lastRoute 被非所有者 DM 覆盖，当所有这些条件为真时，OpenClaw 从 allowFrom 推断固定的所有者：

  • allowFrom 恰好有一个非通配符条目。
  • 该条目可以标准化为该渠道的具体发送者 ID。
  • 入站 DM 发送者与该固定所有者不匹配。

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

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

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

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

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

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

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

广播群组让你可以为同一个对等运行多个代理，当 OpenClaw 通常会回复时（例如：在 WhatsApp 群组中，在提及/激活门控之后）。

配置：

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

参见：Broadcast Groups。

配置概述

  • 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。

这在所有渠道中是一致的。