频道与路由

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

核心概念

频道（Channel）：whatsapp、telegram、discord、slack、signal、imessage、webchat。
账户 ID（AccountId）：每个频道的账户实例（如支持多账户）。
可选的频道默认账户：channels.<channel>.defaultAccount 指定当出站路径未指定 accountId 时使用的账户。
- 在多账户配置中，当配置了两个或更多账户时，请显式设置默认账户（defaultAccount 或 accounts.default）。否则，回退路由可能会选取第一个标准化的账户 ID。
代理 ID（AgentId）：一个隔离的工作空间 + 会话存储（“大脑”）。
会话键（SessionKey）：用于存储上下文和控制并发的桶键。

会话键格式（示例）

私信默认合并到代理的 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

私信路由主会话固定

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

allowFrom 只有一个非通配符条目。
该条目可以标准化为该频道的具体发送者 ID。
入站私信的发送者与该固定所有者不匹配。

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

路由规则（代理选择方式）

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

精确对端匹配（bindings 中的 peer.kind + peer.id）。
父级对端匹配（线程继承）。
公会 + 角色匹配（Discord）通过 guildId + roles。
公会匹配（Discord）通过 guildId。
团队匹配（Slack）通过 teamId。
账户匹配（频道上的 accountId）。
频道匹配（该频道的任意账户，accountId: "*"）。
默认代理（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} 模板覆盖存储路径。

Gateway 和 ACP 会话发现机制还会扫描默认 agents/ 根目录和模板化 session.store 根目录下的磁盘代理存储。被发现的存储必须位于解析后的代理根目录内，并使用标准的 sessions.json 文件。符号链接和根目录外的路径会被忽略。

WebChat 行为

WebChat 附加到所选代理，默认使用该代理的主会话。因此，WebChat 可以让你在一处查看该代理的跨频道上下文。

回复上下文

入站回复包含：

ReplyToId、ReplyToBody 和 ReplyToSender（如可用）。
引用内容以 [Replying to ...] 块的形式追加到 Body。

这在所有频道中保持一致。