频道与路由

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

关键术语

Channel：whatsapp、telegram、discord、slack、signal、imessage、webchat。
AccountId：每频道账户实例（支持时）。
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。

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

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

精确对等匹配（bindings 带 peer.kind + peer.id）。
Guild 匹配（Discord）经 guildId。
Team 匹配（Slack）经 teamId。
Account 匹配（频道上的 accountId）。
Channel 匹配（该频道上的任意账户）。
默认代理（agents.list[].default，否则首个列表条目，回退到 main）。

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

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

广播群组让你为同一对等端运行多个代理（当 Moltbot 通常会回复时，例如 WhatsApp 群组中提及/激活门控后）。配置见英文文档或 Broadcast Groups。

配置概览

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

会话存储位于状态目录（默认 ~/.clawdbot）：~/.clawdbot/agents/<agentId>/sessions/sessions.json，JSONL 转录同目录。可通过 session.store 与 {agentId} 模板覆盖。WebChat 附加到所选代理并默认使用该代理的 main 会话，因此可在一处查看该代理的跨频道上下文。

回复上下文

入站回复包含：ReplyToId、ReplyToBody、ReplyToSender（可用时）。引用上下文作为 [Replying to ...] 块追加到 Body。各频道一致。