ClawCN - OpenClaw 中文版

主题

频道与路由 ​

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

关键术语 ​

  • 频道: 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. 精确对等匹配(bindings 带有 peer.kind + peer.id)。
  2. 服务器匹配(Discord)通过 guildId。
  3. 团队匹配(Slack)通过 teamId。
  4. 账户匹配(频道上的 accountId)。
  5. 频道匹配(该频道上的任何账户)。
  6. 默认代理(agents.list[].default,否则为列表第一项,回退到 main)。

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

广播组(运行多个代理) ​

广播组允许您在 OpenClaw 通常会回复时为同一对等方运行多个代理(例如:在 WhatsApp 群组中,在提及/激活门控之后)。

配置:

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

参见:广播组。

配置概览 ​

  • agents.list: 命名的代理定义(工作区、模型等)。
  • bindings: 将入站频道/账户/对等方映射到代理。

示例:

json5
{
  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} 模板覆盖存储路径。

WebChat 行为 ​

WebChat 附加到选定的代理,默认使用代理的主会话。因此,WebChat 让您可以在一个地方查看该代理的跨频道上下文。

回复上下文 ​

入站回复包括:

  • ReplyToId、ReplyToBody 和 ReplyToSender(如果可用)。
  • 引用的上下文作为 [Replying to ...] 块附加到 Body。

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