OpenClaw 配置入门：dmPolicy、allowlist、groups 应该怎么写

入门 新手 预计 17 分钟 发布于 2026/2/21

为什么这篇值得先看

OpenClaw 配置难点不在 JSON5 语法，而在你到底想让谁进来、什么时候进来、进来后是否必须被点名。

先抓住这 3 个关键点

• dmPolicy 解决私聊准入，groups / groupPolicy 解决群聊准入，requireMention 解决群里触发阈值。
• allowlist 不是可有可无的补充，而是把 OpenClaw 用稳的关键工具。
• 配置写得清楚，后面排错和团队协作才不靠猜。

实操步骤

1. 先把“私聊规则”和“群聊规则”分开思考，不要混成一个大块配置。
2. 决定 dmPolicy 是 pairing、allowlist、open 还是 disabled，再写 allowFrom。
3. 对 groups 单独处理 requireMention，别默认群里所有消息都应该触发助手。
4. 每改一次策略，都回到实际聊天场景里做一次验证，不要只看文件本身。

配置或命令示例

{
  channels: {
    telegram: {
      dmPolicy: "allowlist",
      allowFrom: ["tg:123456789"],
      groups: { "*": { requireMention: true } }
    }
  }
}

常见坑

• 把 dmPolicy 和 groupPolicy 混着想，导致私聊、群聊都表现异常。
• allowlist 写对了值，但没核对账号格式，最后还是进不来。
• 想让群里更安静，却忘记 requireMention 这种最直接的降噪开关。

完成检查

• 你能解释每个策略字段控制的是哪一层行为。
• 你的私聊和群聊至少已经不是“一把梭”的默认开放状态。
• 别人接手你的配置时，也能较快看懂它在做什么。

为什么建议把这篇收藏起来

• 这类配置解释文是最容易被收藏的常青内容之一。
• 每次扩渠道、加群或加人，都会回到这篇。