故障排除

- 验证 `groupPolicy`
- 验证 `channels.discord.guilds` 下的服务器白名单
- 如果存在服务器 `channels` 映射，则仅允许列出的频道
- 验证 `requireMention` 行为和提及模式

当有效策略为 `allowlist` 但未配置任何服务器时，Control UI 频道详情和 `openclaw channels status` 会发出警告。请将你的服务器添加到 `channels.discord.guilds` 下，或在被覆盖时添加到账户的 `guilds` 映射中。显式的 `channels.discord.accounts.default.guilds` 映射也会覆盖顶层映射，即使账户映射为空。

如果状态报告配置重载被推迟，请等待当前工作完成后再刷新。成功的频道停止/启动不会应用未发布的配置。该警告用于区分等待发布配置与发布后被推迟的频道工作；仅凭连接健康状况并不能确认策略更改已生效。

有用的检查：

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Bot 撰写的消息在正常的提及和访问规则下默认会被接受。

请保持适合该房间的提及和白名单规则。设置 `channels.discord.allowBots=false` 可禁用 Bot 触发的回合，或设置 `channels.discord.allowBots="mentions"` 以仅接受提及该 Bot 的 Bot 消息。这些设置不会隐藏可访问的 Bot 撰写的历史记录或人工选择的回复上下文。
在 `"mentions"` 模式下，仅凭回复 ping 元数据并不算作提及。Bot 回复需要有主动的原生提及，或在 Markdown 代码之外配置的文本/记录提及。

OpenClaw 还提供了共享的 [Bot 循环保护](../bot-loop-protection.md)。每当 `allowBots` 允许 Bot 撰写的消息进入分发流程时，Discord 会将入站事件映射为 `(account, channel, bot pair)` 事实，通用配对守卫会在其超过配置的事件预算后抑制该配对。该守卫限制快速的 Bot 到 Bot 循环；低于预算的交互可以继续。它不影响人类消息或低于预算的一次性 Bot 回复。

默认设置（每当允许 Bot 撰写的消息时生效）：

- `maxEventsPerWindow: 20` -- Bot 配对可以在滑动窗口内交换 20 条消息
- `windowSeconds: 60` -- 滑动窗口长度
- `cooldownSeconds: 60` -- 一旦预算超限，一分钟内任何方向的额外 Bot 到 Bot 消息都会被丢弃

在 `channels.defaults.botLoopProtection` 下配置一次共享默认值，然后在合法工作流需要更多余量时覆盖 Discord。优先级为：

- `channels.discord.accounts.<account>.botLoopProtection`
- `channels.discord.botLoopProtection`
- `channels.defaults.botLoopProtection`
- 内置默认值

Discord 使用通用的 `maxEventsPerWindow`、`windowSeconds` 和 `cooldownSeconds` 键。

{
  channels: {
    defaults: {
      botLoopProtection: {
        maxEventsPerWindow: 20,
        windowSeconds: 60,
        cooldownSeconds: 60,
      },
    },
    discord: {
      // Optional Discord-wide override. Account blocks override individual
      // fields and inherit omitted fields from here.
      botLoopProtection: {
        maxEventsPerWindow: 4,
      },
      accounts: {
        alpha: {
          // Alpha listens to other bots only when they mention it.
          allowBots: "mentions",
        },
        bravo: {
          // Bravo listens to all bot-authored Discord messages.
          allowBots: true,
          mentionAliases: {
            // Lets Bravo write an Alpha Discord mention with the configured user id.
            Alpha: "ALPHA_DISCORD_USER_ID",
          },
          botLoopProtection: {
            // Allow up to five messages per minute before suppressing the pair.
            maxEventsPerWindow: 5,
            windowSeconds: 60,
            cooldownSeconds: 90,
          },
        },
      },
    },
  },
}