Discord（Bot API）

状态：通过官方 Discord Gateway 为 DM 和服务器频道做好准备。

Discord DM 默认为配对模式。 本机命令行为和命令目录。 跨频道诊断和修复流程。

快速设置

您需要创建一个带有机器人的新应用，将机器人添加到您的服务器，然后将其配对到 OpenClaw。我们建议将机器人添加到您自己的私有服务器。如果您还没有，先创建一个（选择创建自己的 > 为我和我的朋友）。

前往 [Discord 开发者门户](https://discord.com/developers/applications) 并点击**新应用**。将其命名为"OpenClaw"之类的名称。 
点击侧边栏上的**机器人**。将**用户名**设置为您称呼 OpenClaw 代理的名称。
 仍在**机器人**页面上，向下滚动到**特权 Gateway 意图**并启用： 
- **消息内容意图**（必需）
- **服务器成员意图**（推荐；需要角色白名单和名称到 ID 匹配）
- **在线状态意图**（可选；仅需要在线状态更新）
 在**机器人**页面上向上滚动并点击**重置令牌**。 
<Note>
尽管名称如此，这会生成您的第一个令牌 - 没有什么被"重置"。
</Note>

复制令牌并保存。这是您的**机器人令牌**，您很快就会需要它。
 点击侧边栏上的 **OAuth2**。您将生成具有正确权限的邀请 URL 以将机器人添加到您的服务器。 
向下滚动到 **OAuth2 URL 生成器**并启用：

- `bot`
- `applications.commands`

下面将出现一个**机器人权限**部分。启用：

- 查看频道
- 发送消息
- 读取消息历史
- 嵌入链接
- 附加文件
- 添加反应（可选）

复制底部生成的 URL，将其粘贴到浏览器中，选择您的服务器，然后点击**继续**以连接。您现在应该在 Discord 服务器中看到您的机器人。
 回到 Discord 应用，您需要启用开发者模式以便可以复制内部 ID。 
1. 点击**用户设置**（头像旁边的齿轮图标）→ **高级** → 切换**开发者模式**

配置

基本配置

{
  channels: {
    discord: {
      enabled: true,
      botToken: "YOUR_BOT_TOKEN",
      dmPolicy: "pairing",
    },
  },
}

DM 策略

  • pairing（默认）：未知发件人需要批准
  • allowlist：仅允许白名单中的用户
  • open：允许所有 DM
  • disabled：禁用 DM

群组配置

{
  channels: {
    discord: {
      enabled: true,
      botToken: "YOUR_BOT_TOKEN",
      groupPolicy: "allowlist",
      groupAllowFrom: ["USER_ID_1", "USER_ID_2"],
      groups: {
        "CHANNEL_ID": {
          requireMention: true,
        },
      },
    },
  },
}

权限

机器人需要以下权限：

  • 查看频道
  • 发送消息
  • 读取消息历史
  • 嵌入链接
  • 附加文件
  • 添加反应（可选）

斜杠命令

OpenClaw 支持 Discord 斜杠命令。用户可以：

  • /new - 开始新会话
  • /reset - 重置会话
  • /help - 获取帮助

请参阅斜杠命令了解更多详情。

故障排除

机器人不响应

  • 确认机器人令牌正确
  • 检查机器人是否已添加到服务器
  • 验证权限

消息未发送

  • 检查频道 ID 正确
  • 确认机器人有发送消息权限
  • 验证 WebSocket 连接

DM 不工作

  • 检查 DM 策略设置
  • 确认配对已批准

命令

# 检查 Discord 状态
openclaw channels status discord

# 查看配对请求
openclaw pairing list discord

# 批准配对
openclaw pairing approve discord <CODE>

# 查看日志
openclaw logs --channel discord

安全

  • 保护机器人令牌安全
  • 使用 DM 策略限制未知发件人
  • 定期审查服务器权限
  • 监控配对请求

相关链接