Discord门禁

DM 政策

channels.discord.dmPolicy 控制 DM 访问。 channels.discord.allowFrom 是 DM 许可名单。

• pairing（默认）
• allowlist（需要至少一个 allowFrom 发送者）
• open（需要 channels.discord.allowFrom 包含 "*"）
• disabled

如果 DM 策略不是 open，则未知用户会被阻止（或在 pairing 模式下被提示配对）。

多账号优先级：

• Omited 账户 dmPolicy 和 groupPolicy 继承通道根。明确的账户政策获胜；如果未设置任何范围，则默认值分别保留为 pairing 和 allowlist。
• channels.discord.accounts.default.allowFrom 只适用于 default 账号。
• 对于单个账号，allowFrom 的优先级高于旧的 dm.allowFrom。
• 命名帐户在其自己的 allowFrom 和旧 dm.allowFrom 未设置时继承 channels.discord.allowFrom。
• 命名账号不会继承 channels.discord.accounts.default.allowFrom。

为兼容性起见，旧版 channels.discord.dm.policy 和 channels.discord.dm.allowFrom 仍会被读取。openclaw doctor --fix 会在不改变访问权限的前提下尽可能将它们迁移到 dmPolicy 和 allowFrom。

交付时的 DM 目标格式：

• user:<id>
• <@id> 提及

当通道默认值处于活动状态时，裸数字 ID 通常会解析为通道 ID，但为了兼容性，帐户的有效 DM allowFrom 中列出的 ID 会被视为用户 DM 目标。

访问组

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

访问组名称在消息通道之间共享。对于静态组，请使用 type: "message.senders"，其成员以每个频道的正常 allowFrom 语法表示；或者，当 Discord 频道的当前 ViewChannel 受众应动态定义成员资格时，请使用 type: "discord.channelAudience"。共享访问组行为：访问组。

{  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 发送者属于已配置的 guild，并且在应用角色和频道覆盖后，当前对已配置频道拥有有效的 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 解析成员。

行会政策

guild 处理由 channels.discord.groupPolicy 控制：

• open
• allowlist
• disabled

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

allowlist 行为：

• guild 必须匹配 channels.discord.guilds（优先使用 id，也接受 slug）
• 可选发件人白名单：users（推荐稳定 ID）和 roles（仅限角色 ID）；如果配置了其中之一，则当发件人与 users OR roles 匹配时允许发件人
• direct name/tag 匹配默认关闭；仅启用 channels.discord.dangerouslyAllowNameMatching: true 作为碎玻璃兼容模式
• users支持names/tags，但ID更安全；使用 name/tag 条目时 openclaw security audit 发出警告
• 如果某个 guild 配置了 channels，未列出的频道会被拒绝
• 如果某个 guild 没有 channels 块，则该 allowlist guild 中的所有频道都被允许

示例：

{  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 选择进入仅限 env 的自动配置；该路径使用 groupPolicy="allowlist" 并记录警告，即使 channels.defaults.groupPolicy 是 open。

提及和群组私信

guild 消息默认按提及进行门控。

提及检测包括：

• 显式 bot 提及
• 已配置的提及模式（agents.entries.*.groupChat.mentionPatterns，回退为 messages.groupChat.mentionPatterns）
• 支持场景下对 bot 的隐式回复行为

编写出站 Discord 消息时，请使用支持的提及语法：用户为 <@USER_ID>、通道为 <#CHANNEL_ID>、角色为 <@&ROLE_ID>。请勿使用旧版 <@!USER_ID> 昵称提及表单。

requireMention 根据 guild/channel （channels.discord.guilds...） 进行配置。

将其合并到现有的公会条目中，保留其频道和发件人白名单：

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

对于指定帐户，请使用 channels.discord.accounts.<accountId>.intents 和 .guilds。要限制对一个父频道的覆盖，请将 requireMentionInBotThreads: false 添加到其现有行会 channels.<channelId> 条目。添加新频道映射还会更改 guild 允许列表 。

Guild/channel并且发件人白名单仍然适用。其他用户创建的父频道和线程保留其配置的提及要求；未知的线程所有权不会启用覆盖。使能够消息内容意图在不和谐开发者Portal也intents.messageContent in OpenClaw。没有它，Discord省略普通未提及的公会消息内容。通过让机器人创建一个线程并从允许的帐户发送未提及的后续内容来进行验证。看机器人创建的线程策略对于其他渠道。

ignoreOtherMentions 有选择地删除发送给另一个身份但不发送给机器人的消息。这涵盖了明确的 user/role 提及（不包括 @everyone/@here）以及对另一个非 webhook 机器人的回复。明确提及当前机器人仍然有效。

群组 DM：

• 默认：忽略（dm.groupEnabled=false）
• 通过 dm.groupChannels 的可选允许列表（通道 ID 或 slugs）