Channel 与路由

OpenClaw 会把回复路由回消息来源的 Channel。模型不会选择 Channel，路由是确定性的，由主机配置控制。

核心术语

  • Channel：whatsapp、telegram、discord、slack、signal、imessage、webchat。
  • AccountId：每个 Channel 的账号实例（如果支持的话）。
  • AgentId：一个独立的 Workspace + Session 存储（“大脑”）。
  • SessionKey：用于存储上下文和控制并发的桶键。

Session key 的格式（示例）

私信会合并到 Agent 的 main Session：

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

群组和频道在每个 Channel 中保持隔离：

  • 群组：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

路由规则（如何选择 Agent）

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

  1. 精确对等匹配（bindings 中的 peer.kind + peer.id）。
  2. Guild 匹配（Discord）通过 guildId。
  3. Team 匹配（Slack）通过 teamId。
  4. 账号匹配（Channel 上的 accountId）。
  5. Channel 匹配（该 Channel 上的任何账号）。
  6. 默认 Agent（agents.list[].default，否则取列表第一项，最后回退到 main）。

匹配到的 Agent 决定了使用哪个 Workspace 和 Session 存储。

Broadcast 群组（运行多个 Agent）

Broadcast 群组让你可以为同一个对等方运行多个 Agent，在 OpenClaw 通常会回复的时候（例如：在 WhatsApp 群组中，经过提及/激活门控后）。

配置：

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

参见：Broadcast 群组。

配置概览

  • agents.list：命名的 Agent 定义（Workspace、模型等）。
  • bindings：将入站 Channel/账号/对等方映射到 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" },
  ],
}

Session 存储

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

  • ~/.openclaw/agents/<agentId>/sessions/sessions.json
  • JSONL 转录文件与存储放在一起

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

WebChat 行为

WebChat 会附加到选定的 Agent，并默认使用该 Agent 的 main Session。因此，WebChat 让你可以在一个地方查看该 Agent 的跨 Channel 上下文。

回复上下文

入站回复包含：

  • ReplyToId、ReplyToBody 和 ReplyToSender（如果可用）。
  • 引用的上下文会作为 [Replying to ...] 块追加到 Body。

这在所有 Channel 中都是一致的。