配置 Channel

Channel 是 OpenClaw 接入外部消息平台的边界。你可以把它理解成“谁能把消息送进 Agent”。新手配置 Channel 时，优先考虑访问控制，不要先追求接入的平台数量。

1. 先理解 Channel 管什么

每个消息平台都有自己的账号、token、群组、thread 和身份格式，但 OpenClaw 把几个核心问题统一了：

• 这个渠道要不要启动。
• 哪些私信可以进来。
• 哪些群组可以进来。
• 群组消息是否必须 mention 才触发回复。
• 多账号时如何区分个人账号、工作账号和支持账号。
• 某个频道是否固定使用特定模型。
• 这个入口最终路由到哪个 Agent。

这些都是入口边界。入口边界配置错了，后面的 Agent、tools、workspace 配得再好也会被错误输入影响。

flowchart TD
    Sender["外部发送者"]
    Channel["Channel"]
    Access["DM / group access"]
    Mention["mention gating"]
    Binding["binding 选择 Agent"]
    Session["session key"]
    Agent["Agent"]

    Sender --> Channel
    Channel --> Access
    Access --> Mention
    Mention --> Binding
    Binding --> Session
    Session --> Agent

    style Channel fill:#e0f2fe,stroke:#0284c7,stroke-width:2px
    style Access fill:#fee2e2,stroke:#ef4444,stroke-width:2px
    style Agent fill:#dcfce7,stroke:#22c55e,stroke-width:2px

2. 私信策略怎么选

官方 DM policy 有四类：

新手默认选 pairing 或 allowlist。个人助手、家庭助手、工作助手都不应该默认 open。

pairing 有几个关键事实：

• pairing code 8 位、全大写、避开易混淆字符。
• pairing code 1 小时过期。
• 每个 channel 的 pending DM pairing request 默认最多 3 个。
• 批准 DM pairing code 只允许这个发送者私信访问，不会自动允许群组控制。

openclaw pairing list telegram
openclaw pairing approve telegram <CODE>

3. 群组策略怎么选

群组比私信更容易出问题，因为群里每个人都可能说话，消息里还会夹杂转发、引用、链接和玩笑。

官方 group policy 的基本含义是：

新手建议：群组先保持 allowlist，再开启 mention gating。只有当你能解释“这个群为什么可以触发 Agent”时，才把它放进允许列表。

如果 provider block 完全缺失，runtime group policy 会 fail-closed 回到 allowlist 并给启动 warning。这是好事：没配置清楚就不要让群消息进来。

4. Mention gating 为什么重要

群聊里不应该让 Agent 响应每一句话。Mention gating 的作用是：Agent 可以看到上下文，但只有被点名时才回复。

官方文档也强调，群组消息默认应该依赖 mention 或显式激活方式。新手配置时，先把 mention pattern 设得简单、明确，避免常用词误触发。

一个好规则是：群里的人需要有意识地叫它，它才行动。

WhatsApp 例子里，群组可以这样要求 mention：

{
  channels: {
    whatsapp: {
      groups: {
        "*": { requireMention: true },
      },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          historyLimit: 50,
          mentionPatterns: ["@?openclaw"],
        },
      },
    ],
  },
}

5. 多账号时先隔离 session

多账号不是多填几个 token。它会影响身份、审计、路由和上下文隔离。

如果同一个 Gateway 里有个人账号和工作账号，至少要想清楚：

• accountId 怎么命名，方便日志和路由区分。
• DM session 是否按 channel、account、peer 隔离。
• 不同账号是否路由到不同 Agent。
• 不同 Agent 是否使用不同 workspace 和 tools。

如果两个账号共享同一个 main session，个人上下文、工作上下文和权限暗示可能混在一起。

Session key 常见形状：

6. Channel binding 怎么选 Agent

OpenClaw 路由 inbound message 时会选择一个 Agent。大致顺序是：精确 peer、thread parent、Discord guild / roles、Slack team、account、channel、default agent。

这意味着 routing 是确定性的，不是模型临时选择。

7. 按频道指定模型

channels.modelByChannel 适合把具体频道固定到某个模型。它只应服务明确场景：

• 高价值支持频道用强模型。
• 低风险通知频道用低成本模型。
• 截图或长上下文多的频道用更合适的模型。

不要把模型覆盖当成权限控制。模型更强不等于更安全；入口安全仍然靠 allowlist、mention、session 和 tools。

{
  channels: {
    modelByChannel: {
      telegram: {
        "-1000000000000": "openai/gpt-4.1-mini",
        "-1000000000000:topic:99": "anthropic/claude-sonnet-4-6",
      },
    },
  },
}

8. 支持哪些渠道

OpenClaw 支持多个消息平台同时接入。官方当前列出的入口包括 Discord、Feishu、Google Chat、IRC、LINE、Matrix、Mattermost、Microsoft Teams、Nextcloud Talk、QQ Bot、Signal、Slack、Telegram、Twitch、WebChat、WhatsApp、Zalo 等。

新手不要同时接十个平台。最快跑通通常是 Telegram；WhatsApp 需要 QR pairing，并且在磁盘上保留更多状态。

9. 新手常见坑

• 为了“先跑通”把 DM 设成 open。
• 群组开了 open，但 mention pattern 太宽。
• 多账号共用一个 workspace 和 session。
• 只配置 token，不配置 allowlist。
• 公开入口仍然加载完整 tools。
• 频道模型覆盖后，以为风险也被解决了。
• DM pairing 批准后，以为自动获得群组权限。
• bindings 没写清，导致工作入口落到 main Agent。

10. 怎么判断 Channel 配置健康

健康标准：

• 只接入当前真正要用的渠道。
• DM 默认是 pairing 或 allowlist。
• 群组默认是 allowlist，并要求 mention。
• 多账号能从日志里区分来源。
• 不同角色入口能路由到不同 Agent 或不同 workspace。
• openclaw doctor 没有访问控制相关警告。

新手先把一个渠道跑稳，再接第二个。不要同时接十个平台排错。

11. 本章自检

1. pairing、allowlist、open、disabled 的差异是什么？
2. 群聊为什么要先 allowlist，再做 mention gating？
3. Channel binding 和 model override 分别解决什么问题？

12. 接下来去哪

13. 官方资料

• Configuration — channels
• Chat channels
• Group messages
• Pairing
• Channel routing