3.5 KiB

Raw Blame History

read_when

summary

title

x-i18n

更改渠道路由或收件箱行为

每个渠道（WhatsApp、Telegram、Discord、Slack）的路由规则及共享上下文

渠道路由

generated_at	model	provider	source_hash	source_path	workflow
2026-02-01T20:22:21Z	claude-opus-4-5	pi	1a322b5187e32c82fc1e8aac02437e2eeb7ba84e7b3a1db89feeab1dcf7dbbab	channels/channel-routing.md	14

渠道与路由

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

路由规则（如何选择智能体）

路由为每条入站消息选择一个智能体：

精确对端匹配（bindings 中的 peer.kind + peer.id）。
Guild 匹配（Discord）通过 guildId。
Team 匹配（Slack）通过 teamId。
账户匹配（渠道上的 accountId）。
渠道匹配（该渠道上的任意账户）。
默认智能体（agents.list[].default，否则取列表第一项，兜底为 main）。

匹配到的智能体决定使用哪个工作区和会话存储。

广播组（运行多个智能体）

广播组允许你为同一对端运行多个智能体，在 OpenClaw 正常回复时触发（例如：在 WhatsApp 群组中，经过提及/激活门控之后）。

配置：

{
  broadcast: {
    strategy: "parallel",
    "120363403215116621@g.us": ["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} 模板来覆盖存储路径。

WebChat 行为

WebChat 连接到所选智能体，并默认使用该智能体的主会话。因此，WebChat 让你可以在一个地方查看该智能体的跨渠道上下文。

回复上下文

入站回复包含：

ReplyToId、ReplyToBody 和 ReplyToSender（在可用时）。
引用的上下文会以 [Replying to ...] 块的形式追加到 Body 中。

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

3.5 KiB Raw Blame History Unescape Escape