跳转至

设置

运行 Discord 机器人所需的一切:创建应用、授予 Intents、邀请它加入服务器、完成配对,并准备一个服务器(Guild)工作区。

快速设置

创建一个带机器人的 Discord 应用,将机器人添加到你的服务器,并让它与 OpenClaw 配对。如果可以,请使用私人服务器;如有需要,先创建一个(Create My Own > For me and my friends)。

1. 创建 Discord 应用和机器人

在 Discord Developer Portal 中,点击 New Application 并为其命名(例如“OpenClaw”)。

在侧边栏打开 Bot,将 Username 设置为你的智能体的名称。

2. 启用特权 Intents

仍在 Bot 页面,在 Privileged Gateway Intents 下启用:

  • Message Content Intent(处理普通服务器消息所必需)
  • Server Members Intent(推荐;角色白名单、名称转 ID 的匹配以及频道受众访问组都需要)
  • Presence Intent(可选;仅用于在线状态更新)

3. 复制你的 Bot Token

在 **Bot** 页面,点击 **Reset Token** 并复制 Token。

Note

虽然按钮叫“Reset Token”,但这里实际生成的是你的第一个 Token——并不是在“重置”什么。

4. 生成邀请链接并将机器人添加到服务器

在侧边栏打开 OAuth2。在 OAuth2 URL Generator 中,启用以下 Scopes:

  • bot
  • applications.commands

在出现的 Bot Permissions 部分中,至少启用:

General Permissions - View Channels

Text Permissions - Send Messages - Read Message History - Embed Links - Attach Files - Add Reactions(可选)

以上是普通文本频道所需的最低权限。如果机器人要在帖子中发消息——包括创建或延续帖子的论坛频道或媒体频道工作流——还要启用 Send Messages in Threads。

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

5. 启用开发者模式并获取你的 ID

在 Discord 应用中,启用开发者模式(Developer Mode),以便复制 ID:

  1. User Settings(齿轮图标)→ Developer → 打开 Developer Mode 开关 (移动端:App Settings → Advanced)
  2. 右键点击你的服务器图标 → Copy Server ID
  3. 右键点击你自己的头像 → Copy User ID

请将 Server ID 和 User ID 与你的 Bot Token 放在一起;下一步你需要用到这三项。

6. 允许服务器成员向你发送私信

配对要成功,Discord 必须允许机器人向你发送私信。右键点击你的服务器图标 → Privacy Settings → 打开 Direct Messages 开关。

如果你通过 OpenClaw 使用 Discord 私信,请保持此选项开启。如果只用服务器频道,配对完成后即可将其关闭。

7. 安全地设置你的 Bot Token(不要通过聊天发送)

Bot Token 是机密信息。在向你的智能体发送消息之前,先在运行 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" },
    },
  },
}
JSON5
openclaw config patch --file ./discord.patch.json5 --dry-run
openclaw config patch --file ./discord.patch.json5
openclaw gateway
如果 OpenClaw 已作为后台服务运行,请通过 OpenClaw Mac 应用重启它,或停止并重启 `openclaw gateway run` 进程。
对于托管服务安装,请在已设置 `DISCORD_BOT_TOKEN` 的 shell 中运行 `openclaw gateway install`;也可以将变量写入 `~/.openclaw/.env`,以便服务在重启后能解析该 env SecretRef。
如果你的主机被 Discord 的启动应用查询阻止或限流,请从 Developer Portal 设置 application/client ID,以便启动时跳过该 REST 调用:默认账户使用 `channels.discord.applicationId`,或按机器人分别设置 `channels.discord.accounts.<accountId>.applicationId`。

8. 配置 OpenClaw 并配对

在现有频道(例如 Telegram)上与你的 OpenClaw 智能体对话并告诉它。如果 Discord 是你的第一个频道,请改用 CLI / 配置选项卡。

“我已经在配置中设置了我的 Discord Bot Token。请使用 User ID <user_id> 和 Server ID <server_id> 完成 Discord 设置。”

    基于文件的配置:
{
  channels: {
    discord: {
      enabled: true,
      token: {
        source: "env",
        provider: "default",
        id: "DISCORD_BOT_TOKEN",
      },
    },
  },
}
    默认账户的 Env(环境变量)回退:
DISCORD_BOT_TOKEN=...
    对于脚本化或远程设置,请用 `openclaw config patch --file ./discord.patch.json5 --dry-run` 写入相同的 JSON5 块,然后去掉 `--dry-run` 重新运行。纯文本的 `token` 字符串同样有效;`channels.discord.token` 在 env/file/exec/store 这些 provider 下均支持 SecretRef 值。参见 [机密管理](../../gateway/secrets.md)。

    对于多个 Discord 机器人,请将每个 Bot Token 和 application ID 放在各自的账户下。顶层的 `channels.discord.applicationId` 会被各账户继承,因此只有在所有账户都使用同一个 application ID 时,才应在此处设置。
{
  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",
        },
      },
    },
  },
}

9. 批准首次私信配对

Gateway 启动后,在 Discord 中给你的机器人发私信,它会回复一个配对码。

在你现有的频道上,将配对码发送给你的智能体:

"批准此 Discord 配对代码:<CODE>"

openclaw pairing list discord
openclaw pairing approve discord <CODE>

配对代码在 1 小时后过期。批准后,请在 Discord 私聊中与你的智能体聊天。

如果 Discord 无法授予 Message Content Intent,OpenClaw 仍可在私聊以及用户明确提及机器人的服务器频道中运行。设置 channels.discord.intents.messageContent: false,以便 Gateway 不请求不可用的特权意图,并在每个已配置的服务器频道上保持 requireMention: true。在此模式下,Discord 会省略其他服务器消息中用户创建的内容。

Note

Token 解析是账户感知的。配置中的 token 值优先于环境变量回退值,且 DISCORD_BOT_TOKEN 仅用于默认账户。 如果两个已启用的 Discord 账户解析到同一个 bot token,OpenClaw 只会为该 token 启动一个 Gateway 监视器:来自配置的 token 优先于环境变量回退值;否则第一个已启用账户生效,重复账户会被报告为已禁用,原因为 duplicate bot token。 对于高级出站调用(message tool/频道操作),该调用会显式使用 per-call token。这适用于 send 以及 read/check 类操作(read/search/fetch/thread/pins/permissions)。账户策略/重试设置仍然来自当前运行时快照中选定的账户。

一旦私聊可用,你就可以将你的服务器变成一个完整的工作区,其中每个频道都拥有自己的智能体会话和独立上下文。推荐用于只有你和机器人的私人服务器。

1. 将你的服务器添加到服务器允许列表

这可以让你的智能体在服务器上的任意频道中回复,而不仅仅是私聊。

"将我的 Discord 服务器 ID <server_id> 添加到服务器允许列表"

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

2. 允许无需 @提及 即可回复

默认情况下,智能体仅在服务器频道中被 @提及 时才会回复。在私人服务器上,你可能希望它对每条消息都进行回复。

在服务器频道中,普通回复默认自动发布。对于共享的常驻房间,启用 `messages.groupChat.visibleReplies: "message_tool"`,以便智能体可以静默观察,并只在它认为频道回复有用时才发布。这与最新一代、工具调用可靠的模型(如 GPT-6 Astra)搭配效果最佳。除非工具发送,否则环境房间事件保持静默。有关完整的潜伏模式配置,请参阅 [环境房间事件](../ambient-room-events.md)。

如果 Discord 显示正在输入,且日志显示 token 使用量但没有已发布的消息,请检查该回合是否被配置为环境房间事件,或是否启用了 message-tool 可见回复。

会话繁忙通知也遵循此回复策略。对于环境事件和 message-tool 回复,Discord 会在 Gateway 日志中记录失败和被抑制的通知,而不会发布到房间。

"允许我的智能体在此服务器上无需被 @提及 即可回复"

    在你的服务器配置中设置 `requireMention: false`:
{
  channels: {
    discord: {
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: false,
        },
      },
    },
  },
}
    若要要求可见的群组/频道回复必须通过 message-tool 发送,请设置 `messages.groupChat.visibleReplies: "message_tool"`。

3. 规划服务器频道中的记忆

长期记忆(MEMORY.md)仅在私聊会话中自动加载;服务器频道不会加载它。

"当我在 Discord 频道中提问时,如果你需要来自 MEMORY.md 的长期上下文,请使用 memory_search 或 memory_get。"

对于每个频道共享的上下文,请将稳定指令放在 AGENTS.md 或 USER.md 中(每个会话都会注入)。将长期笔记保存在 MEMORY.md 中,并使用记忆工具按需访问。

现在创建频道并开始聊天。智能体可以看到频道名称,并且每个频道都是一个隔离的会话——设置 #coding、#home、#research 或适合你工作流的任何频道。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw