访问控制

在 `channels.discord.allowFrom` 中，Discord DM 和文本命令授权可以使用动态的 `accessGroup:<name>` 条目。

访问组名称在所有消息频道间共享。对于静态组，使用 `type: "message.senders"`，其成员以各频道正常的 `allowFrom` 语法表示；当 Discord 频道当前的 `ViewChannel` 受众应动态定义成员资格时，使用 `type: "discord.channelAudience"`。共享访问组行为：[访问组](../access-groups.md)。

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
      },
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
  },
}

Discord 文本频道没有独立的成员列表。`type: "discord.channelAudience"` 将成员资格建模为：DM 发送者是所配置公会的成员，并且在应用角色和频道覆盖设置后，当前对所配置频道拥有有效的 `ViewChannel` 权限。

示例：允许任何能看到 `#maintainers` 的人向机器人发送 DM，同时保持 DM 对其他所有人关闭。

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
      membership: "canViewChannel",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers"],
    },
  },
}

你可以混合使用动态和静态条目：

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"],
    },
  },
}

查找失败时默认拒绝。如果 Discord 返回 `Missing Access`、成员查找失败，或者频道属于不同的公会，则 DM 发送者被视为未经授权。

使用频道受众访问组时，请启用 Discord 开发者门户的 **Server Members Intent**。DM 不包含公会成员状态，因此 OpenClaw 会在授权时通过 Discord REST 解析成员。

公会处理由 `channels.discord.groupPolicy` 控制：

- `open`
- `allowlist`
- `disabled`

当存在 `channels.discord` 时，安全基线为 `allowlist`。

`allowlist` 行为：

- 公会必须匹配 `channels.discord.guilds`（优先使用 `id`，也接受 slug）
- 可选的发送者允许列表：`users`（建议使用稳定 ID）和 `roles`（仅限角色 ID）；如果配置了其中任意一项，则发送者在匹配 `users` 或 `roles` 时被允许
- 名称/标签直接匹配默认禁用；仅在紧急破窗兼容模式下启用 `channels.discord.dangerouslyAllowNameMatching: true`
- `users` 支持名称/标签，但 ID 更安全；`openclaw security audit` 会在使用名称/标签条目时发出警告
- 如果公会配置了 `channels`，则未列出的频道会被拒绝
- 如果公会没有 `channels` 块，则该允许列表中公会的所有频道均被允许

示例：

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        "123456789012345678": {
          requireMention: true,
          ignoreOtherMentions: true,
          users: ["987654321098765432"],
          roles: ["123456789012345678"],
          channels: {
            general: { enabled: true },
            help: { enabled: true, requireMention: true },
          },
        },
      },
    },
  },
}

旧的每频道 `allow` 键由 `openclaw doctor --fix` 迁移为 `enabled`。

如果没有 `channels.discord` 块，网关不会从 `DISCORD_BOT_TOKEN` 自动启动 Discord。一旦该块存在，`DISCORD_BOT_TOKEN` 仍作为默认账户的令牌回退。传入 `--ambient-channels` 会选择仅环境变量的自动配置；该路径使用 `groupPolicy="allowlist"` 并记录警告，即使 `channels.defaults.groupPolicy` 为 `open`。

{
  channels: {
    discord: {
      intents: { messageContent: true },
      guilds: {
        "123456789012345678": {
          requireMention: true,
          requireMentionInBotThreads: false,
        },
      },
    },
  },
}