通道与路由

适用范围

在以下情况使用此页面：

• 更改通道路由或收件箱行为

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

关键术语

• 通道：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. 群组匹配（Discord）通过 guildId。
3. 团队匹配（Slack）通过 teamId。
4. 帐户匹配（通道上的 accountId）。
5. 通道匹配（该通道上的任何帐户）。
6. 默认代理（agents.list[].default，否则第一个列表条目，回退到 main）。

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

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

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

配置：

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

请参阅：广播群组。

配置概述

• agents.list：命名代理定义（工作空间、模型等）。
• bindings：将入站通道/帐户/对等方映射到代理。

示例：

{
  agents: {
    list: [
      { id: "support", name: "Support", workspace: "~/clawd-support" }
    ]
  },
  bindings: [
    { match: { channel: "slack", teamId: "T123" }, agentId: "support" },
    { match: { channel: "telegram", peer: { kind: "group", id: "-100123" } }, agentId: "support" }
  ]
}

会话存储

会话存储位于状态目录下（默认 ~/.moltbot）：

• ~/.moltbot/agents/<agentId>/sessions/sessions.json
• JSONL 脚本与存储并存

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

WebChat 行为

WebChat 附加到 选定的代理 并默认为代理的主会话。因此，WebChat 让您在一个地方看到该代理的跨通道上下文。

回复上下文

入站回复包括：

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

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