加入我们的 Telegram 社群 (clawdbotCN) 学习分享和了解更多 →
渠道集成
Discord

Discord 配置

通过 discord.js 库集成 Discord,支持服务器频道和私信。

快速开始

1. 创建 Bot

  1. 访问 Discord Developer Portal (opens in a new tab)
  2. 创建新应用
  3. 进入 Bot 页面,创建 Bot 并复制 Token

2. 启用 Intents

在 Developer Portal 中启用:

  • Message Content Intent (必需)
  • Server Members Intent (推荐)

3. 配置

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

4. 生成邀请链接

设置权限并邀请 Bot 到服务器:

  • View Channels
  • Send Messages
  • Read Message History
  • Embed Links (可选)
  • Attach Files (可选)
  • Add Reactions (可选)

访问控制

私信安全

默认使用配对模式:

{
  channels: {
    discord: {
      dmPolicy: "pairing"
    }
  }
}

频道配置

在共享频道中使用 requireMention 防止意外激活:

{
  channels: {
    discord: {
      groups: {
        "*": {
          requireMention: true
        }
      }
    }
  }
}

频道白名单

只在指定频道响应:

{
  channels: {
    discord: {
      channelAllowlist: [
        "123456789",  // 频道 ID
        "987654321"
      ]
    }
  }
}

完整配置

{
  channels: {
    discord: {
      enabled: true,
      token: "YOUR_BOT_TOKEN",
 
      dmPolicy: "pairing",
      groupPolicy: "open",
 
      textChunkLimit: 2000,
 
      groups: {
        "*": {
          requireMention: true
        }
      }
    }
  }
}

故障排除

Bot 连接但不回复

  • 确认 Message Content Intent 已启用
  • 检查 Bot 有正确的频道权限

诊断命令

clawdbot doctor

下一步