配置 Channel

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

先理解 Channel 管什么

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

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

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

私信策略怎么选

官方 DM policy 有四类：

• pairing：默认思路，未知发送者先拿一次性配对码，owner 批准后才能继续。
• allowlist：只允许允许列表或已配对允许列表里的发送者。
• open：允许所有私信，但需要显式 allowFrom: ["*"]。
• disabled：忽略所有私信。

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

open 只适合你明确在做公开入口，并且已经配好更窄的 tools、sandbox、session 隔离和审计。

群组策略怎么选

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

官方 group policy 的基本含义是：

• allowlist：默认，只允许配置过的群组。
• open：绕过群组允许列表，但 mention gating 仍可生效。
• disabled：阻止所有群组或房间消息。

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

Mention gating 为什么重要

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

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

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

多账号时先隔离 session

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

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

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

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

按频道指定模型

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

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

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

新手常见坑

• 为了“先跑通”把 DM 设成 open。
• 群组开了 open，但 mention pattern 太宽。
• 多账号共用一个 workspace 和 session。
• 只配置 token，不配置 allowlist。
• 公开入口仍然加载完整 tools。
• 频道模型覆盖后，以为风险也被解决了。

---

怎么判断 Channel 配置健康

健康标准：

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

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

官方来源

• OpenClaw Configuration: channels
• OpenClaw Configuration
• OpenClaw Configuration Reference
• OpenClaw Groups

最近更新：2026年5月4日