12. 多渠道统一管理与消息路由

一张网，多个入口

前几章你接了模型（大脑）和渠道（嘴耳）。现在把它们合起来看：

一个网关（Gateway）可以同时挂着 Telegram、Discord、飞书、Web 控制台等好几个渠道。你在任何一处发话，都进同一个网关、由同一套逻辑处理。

这就是”统一管理的意义”——一个大脑，处处可达。不用在每个平台各养一个机器人。

消息原路返回

你从飞书发的，回答就回飞书；从 Telegram 发的，回 Telegram。OpenClaw 默认”原路返回”，不会串台。

这背后的机制叫路由（Routing）：网关记住每条消息来自哪个渠道、哪个会话，回答时按原路送回去。你不用操心，它自动做。

会话怎么折叠

同一种渠道里，不同人的对话怎么区分？靠”会话键”。

以私聊（DM）为例，默认所有私聊都归到同一个 main 会话，键是 agent:main:main。也就是说，不管谁私聊你，都进一个共享上下文。

这未必是你想要的。OpenClaw 用 session.dmScope 控制折叠粒度：

• main：所有私聊共用一个会话（默认）。
• per-peer：按”谁发的”分开，每人一个会话。
• per-channel-peer：按”渠道 + 谁”分开。
• per-account-channel-peer：按”账号 + 渠道 + 谁”分开，最细。

{
  "session": {
    "dmScope": "per-peer"
  }
}

用 bindings 派给不同智能体

这是多渠道管理的精华：bindings（绑定）。

你可以创建多个智能体（Agent），再用 bindings 规定”哪来的消息，交给哪个智能体”。

比如：Telegram 用于工作，Web 控制台用于个人。

{
  "agents": {
    "list": [
      { "id": "main", "default": true, "name": "小沃" },
      { "id": "work", "name": "工作助手" }
    ]
  },
  "bindings": [
    { "agentId": "work", "match": { "channel": "telegram" } },
    { "agentId": "main", "match": { "channel": "webchat" } }
  ]
}

bindings 的匹配有优先级，越具体的规则越优先。从高到低大致是：

1. 精确对象（某个特定用户的私聊或群，含 peer.kind + peer.id）。
2. 线程继承（消息来自某话题线程，继承父级匹配）。
3. 通配对象（同类型里所有对象，peer.id: "*"）。
4. 服务器+角色（Discord 的 guild + roles）。
5. 服务器 / 团队（Discord 的 guild、Slack 的 team）。
6. 渠道账户（accountId）。
7. 渠道级（整个渠道，如所有 Telegram 归某 agent）。
8. 默认智能体。

一条 binding 若写了多个匹配字段（如 peer + guildId），必须全部命中才生效。

越具体的规则，越优先。这样你能把”某个群”单独指给一个家庭助手，其余 Telegram 消息走工作助手。

一个常见玩法：工作/生活分离

很多人这么搭：

• Telegram 私聊 → 工作助手（专业、简洁）。
• 飞书群 → 家庭助手（温馨、有耐心）。
• Web 控制台 → 默认个人助手。

靠 bindings 几行配置就能实现。既隔离了上下文，又不必维护多套网关。

广播组：一条发多处

反过来，也有”一处说、多处听”的需求。比如你想让同一条提醒同时发到 Telegram 和飞书。

OpenClaw 支持广播组（broadcast group）：把多个接收方编成一组，发往该组的消息会复制转发到每个成员。

适合通知类场景：服务器报警、定时日报，一次写好，处处收到。

网关命令复习

管理这张网，离不开网关自身的命令：

# 启动 / 重启 / 停止
openclaw gateway run
openclaw gateway restart
openclaw gateway stop

# 看状态、做健康检查
openclaw gateway status
openclaw gateway health
openclaw gateway probe

status 看服务在不在跑；health 做轻量自检；probe 更深，会探各渠道连通性。排错时这三个很有用。

本章串联

到这里，你已经有了一张完整的网：

• 模型（第 8 章）给大脑；
• 安全（第 9 章）守住门；
• 渠道（第 10–11 章）接上嘴耳；
• 路由（本章）把一切编成一张网。

下一阶段，就是给智能体写人设、装技能，让它真正变成你的数字员工。