OpenClaw Discord Bot 接入指南：9 步完成配置与角色路由

OpenClaw 对 Discord 提供完整支持，包括 DM、频道消息、论坛频道、语音消息和基于角色的 Agent 路由。

快速配置 9 步#

第 1 步：创建 Discord 应用#

访问 Discord Developer Portal，New Application，命名后点击 Bot 侧边栏设置 Bot 用户名。

第 2 步：开启必要 Intent#

Bot 页面 Privileged Gateway Intents 中开启：

• Message Content Intent（必须）
• Server Members Intent（推荐，角色白名单需要）
• Presence Intent（可选）

第 3 步：复制 Bot Token#

Bot 页面点击 Reset Token 生成并保存 Token。

第 4 步：生成邀请链接并添加 Bot 到服务器#

OAuth2 -> URL Generator -> 勾选 bot 和 applications.commands -> Bot Permissions 勾选 View Channels、Send Messages、Read Message History、Embed Links、Attach Files -> 复制 URL 在浏览器中打开并添加到服务器。

第 5 步：开启开发者模式并收集 ID#

用户设置 -> 高级 -> 开发者模式，右键服务器图标复制 Server ID，右键头像复制 User ID。

第 6 步：允许来自服务器成员的 DM#

右键服务器图标 -> 隐私设置 -> 开启直接消息。

第 7 步：安全设置 Bot Token#

在运行 OpenClaw 的机器上执行（不要在聊天中发送 Token）：

openclaw config set channels.discord.token 'YOUR_BOT_TOKEN' --json
openclaw config set channels.discord.enabled true --json
openclaw gateway restart

或直接在 ~/.openclaw/openclaw.json 中配置：

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

第 8 步：配对（通过已有频道告知 Agent）#

通过已有频道（如 Telegram）告诉 Agent： 「我已在配置文件中设置好 Discord Bot Token，请用 User ID YOUR_USER_ID 和 Server ID YOUR_SERVER_ID 完成 Discord 配置。」

第 9 步：批准首次 DM 配对#

Bot 会发来配对码，运行：

openclaw pairing list discord
openclaw pairing approve discord CODE

配对码 1 小时内有效。完成后即可在 Discord 私信中与 Bot 对话。

推荐：设置 Guild 工作区#

DM 接通后，将服务器设置为工作区，每个频道独享独立会话：

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

设置 requireMention 为 false 后，Agent 在私人服务器中无需 @ 即可响应。可以创建不同用途的频道（如 coding、research、home），每个频道保持独立对话历史。

基于角色的 Agent 路由#

不同 Discord 角色路由到不同 Agent：

{
  "bindings": [
    {
      "agentId": "coding",
      "match": {
        "channel": "discord",
        "guildId": "SERVER_ID",
        "roles": ["DEVELOPER_ROLE_ID"]
      }
    },
    {
      "agentId": "main",
      "match": {
        "channel": "discord",
        "guildId": "SERVER_ID"
      }
    }
  ]
}

拥有 Developer 角色的用户消息路由到 coding Agent，其他用户路由到 main Agent。

多账号：多个 Discord Bot#

{
  "channels": {
    "discord": {
      "accounts": {
        "default": { "token": "TOKEN_1" },
        "coding": { "token": "TOKEN_2" }
      }
    }
  }
}

每个 Bot 需要单独邀请到服务器并开启 Message Content Intent。

长期记忆注意事项#

MEMORY.md 默认只在 DM 会话中自动加载，频道中不自动加载。需要时：

• 使用 memory_search 语义搜索记忆
• 使用 memory_get 精确读取特定记忆
• 稳定背景信息放在 AGENTS.md 或 USER.md（每次会话自动注入）

常见问题排查#

Bot 不响应频道消息？检查频道是否在白名单或 requireMention 是否为 false，确认 Bot 有该频道读取权限。

配对后 DM 仍无响应？确认服务器隐私设置已开启直接消息，运行 openclaw pairing list discord 查看配对状态。

原文：Discord - OpenClaw (https://docs.openclaw.ai/channels/discord) | 来源：OpenClaw 官方文档