Discord 设置

创建 Discord 应用程序和机器人

在 Discord 开发人员 Portal 中，单击 新建应用程序 并将其命名（例如“OpenClaw”）。

在侧边栏中打开 机器人，并将 用户名 设置为你的代理名称。

启用特权意图

仍在 机器人 页面，在 特权网关意图 下启用：

• 消息内容意图（普通服务器消息所必需）
• 服务器成员意图（推荐；角色允许列表、名称到 ID 的匹配以及频道受众访问组所必需）
• 在线状态意图（可选；仅用于状态更新）

复制您的机器人令牌

在 机器人 页面，点击 重置令牌 并复制该令牌。

生成邀请 URL 并将机器人添加到您的服务器

在侧边栏中打开 OAuth2。在 OAuth2 URL 生成器 中，启用以下作用域：

• bot
• applications.commands

在出现的 机器人权限 部分，至少启用：

常规权限

• 查看频道

文本权限

• 发送消息
• 阅读消息历史记录
• 嵌入链接
• 附加文件
• 添加反应（可选）

这就是普通文本频道的基础权限。如果机器人还会在线程中发消息——包括会创建或继续线程的论坛或媒体频道工作流——也请启用 在线程中发送消息。

复制生成的 URL，在浏览器中打开，选择你的服务器，然后点击 继续。此时机器人应该会出现在你的服务器中。

启用开发者模式并收集您的 ID

在 Discord 应用程序中，启用开发者模式，以便您可以复制 ID：

1. 用户设置（齿轮图标）→ 开发者 → 打开 开发者模式 （在移动端：应用设置 → 高级）
2. 右键单击你的 服务器图标 → 复制服务器 ID
3. 右键单击你自己的 头像 → 复制用户 ID

将服务器 ID 和用户 ID 与你的机器人令牌一起保存；下一步你会需要这三者。

允许来自服务器成员的 DM

为了使配对正常工作，Discord 必须让机器人 DM 进行操作。右键单击您的 服务器图标 → 隐私设置 → 打开 直接消息。

如果你使用 Discord 私信和 OpenClaw，请保持开启。如果你只使用服务器频道，配对完成后可以将其关闭。

安全地设置您的机器人令牌（不要在聊天中发送）

机器人令牌是机密信息。在向你的代理发送消息之前，先在运行 OpenClaw 的机器上设置它：

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"cat > discord.patch.json5 <<'JSON5'{  channels: {    discord: {      enabled: true,      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },    },  },}JSON5openclaw config patch --file ./discord.patch.json5 --dry-runopenclaw config patch --file ./discord.patch.json5openclaw gateway

如果 OpenClaw 已作为后台服务运行，请通过 OpenClaw Mac 应用程序或停止并重新启动 openclaw gateway run 进程来重新启动它。对于托管服务安装，请从设置了 DISCORD_BOT_TOKEN 的 shell 运行 openclaw gateway install，或将变量存储在 ~/.openclaw/.env 中，以便服务在重新启动后可以解析环境 SecretRef。如果您的主机被 Discord 的启动应用程序查找阻止或速率限制，请从开发人员门户设置 application/client ID，以便启动可以跳过该 REST 调用：默认帐户为 channels.discord.applicationId，或每个机器人为 channels.discord.accounts.<accountId>.applicationId。

配置 OpenClaw 并配对

{  channels: {    discord: {      enabled: true,      token: {        source: "env",        provider: "default",        id: "DISCORD_BOT_TOKEN",      },    },  },}

DISCORD_BOT_TOKEN=...

{  channels: {    discord: {      enabled: true,      accounts: {        personal: {          token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" },          applicationId: "111111111111111111",        },        work: {          token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" },          applicationId: "222222222222222222",        },      },    },  },}

批准第一个 DM 配对

网关运行后，DM 您的机器人将位于 Discord 中。它会回复一个配对码。

openclaw pairing list discordopenclaw pairing approve discord <CODE>

配对代码将在 1 小时后过期。批准后，在 Discord DM 中与您的代理聊天。

将您的服务器添加到公会白名单中

这样可以让你的代理在服务器上的任何频道响应，而不只是私信。

{  channels: {    discord: {      groupPolicy: "allowlist",      guilds: {        YOUR_SERVER_ID: {          requireMention: true,          users: ["YOUR_USER_ID"],        },      },    },  },}

允许不带 @mention 的响应

默认情况下，代理仅在 @mentioned. 时在公会频道中响应。在私人服务器上，您可能希望它响应每条消息。

在公会频道中，普通回复默认会自动发布。对于始终在线的共享房间，请选择 messages.groupChat.visibleReplies: "message_tool"，以便代理可以潜伏并仅在认为频道回复有用时才发布。这最适合最新一代、工具可靠的模型，例如 GPT-6 Astra。除非工具发送，否则环境房间事件将保持安静。请参阅 环境房间事件 了解完整的潜伏模式配置。

如果 Discord 显示正在输入，而且日志显示 token 使用量但没有实际发出消息，请检查该轮次是否被配置为环境房间事件，或者是否启用了消息工具可见回复。

会话繁忙通知也遵循此回复策略。对于环境事件和消息工具回复，Discord 在网关日志中记录故障和抑制通知，而不发布到房间。

{  channels: {    discord: {      guilds: {        YOUR_SERVER_ID: {          requireMention: false,        },      },    },  },}

公会频道内存规划

长期记忆 （MEMORY.md） 仅在 DM 会话中自动加载；公会频道不加载它。