跳到主要内容

频道与路由

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

关键术语​

  • Channel (频道): whatsapp, telegram, discord, slack, signal, imessage, webchat。
  • AccountId: 每个频道的账号实例（支持时）。
  • AgentId: 隔离的工作区 + 会话存储（“大脑”）。
  • SessionKey: 用于存储上下文和控制并发的桶键。

会话键格式 (示例)​

私聊消息会折叠到 Agent 的主 (main) 会话：

  • agent:<agentId>:<mainKey> (默认: agent:main:main)

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

  • 群组: agent:<agentId>:<channel>:group:<id>
  • 频道/房间: agent:<agentId>:<channel>:channel:<id>

线程 (Threads):

  • Slack/Discord 线程会在基础键后追加 :thread:<threadId>。
  • Telegram 论坛话题会在群组键中嵌入 :topic:<topicId>。

示例：

  • agent:main:telegram:group:-1001234567890:topic:42
  • agent:main:discord:channel:123456:thread:987654

路由规则 (如何选择 Agent)​

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

  1. 精确对等匹配 (Exact peer match) (bindings 包含 peer.kind + peer.id)。
  2. 服务器匹配 (Guild match) (Discord) 通过 guildId。
  3. 团队匹配 (Team match) (Slack) 通过 teamId。
  4. 账号匹配 (Account match) (频道上的 accountId)。
  5. 频道匹配 (Channel match) (该频道上的任何账号)。
  6. 默认 Agent (agents.list[].default，否则为列表第一项，回退到 main)。

匹配到的 Agent 决定了使用哪个工作区和会话存储。

广播组 (运行多个 Agent)​

广播组允许你在 Clawdbot 通常会回复时（例如：在 WhatsApp 群组中，经过提到/激活检测后），为同一个对等方运行多个 Agent。

配置：

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

参见：广播组。

配置概览​

  • agents.list: 命名的 Agent 定义（工作区、模型等）。
  • bindings: 将入站频道/账号/对等方映射到 Agent。

示例：

{
  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" }
  ]
}

会话存储​

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

  • ~/.clawdbot/agents/<agentId>/sessions/sessions.json
  • JSONL 副本与存储文件并列存放

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

WebChat 行为​

WebChat 附加到选定的 Agent，并默认使用 Agent 的主会话。正因如此，WebChat 允许你在一个地方查看该 Agent 的跨频道上下文。

回复上下文​

入站回复包括：

  • ReplyToId, ReplyToBody, 和 ReplyToSender（可用时）。
  • 引用上下文会作为 [Replying to ...] 块追加到 Body 中。

这在所有频道中都是一致的。