跳到主要内容

Discord

discord channel 通过 WebSocket 连接 Discord Gateway 接收消息,并通过 REST API 回复文本内容。支持服务器渠道和私信场景。

支持的功能

  • 接收 Discord 消息
  • 服务器和私聊场景支持
  • 文本消息回复
  • slash command 支持

快速开始

  1. 创建 Discord 应用和机器人

    前往 Discord Developer Portal,点击 New Application 创建一个应用。

  2. 启用特权 intents

    在 Bot 设置页面,找到 Privileged Gateway Intents,启用:

    • Message Content Intent(必需)
    • Server Members Intent(推荐)
  3. 获取机器人令牌

    在 Bot 页面点击 Reset Token 复制机器人令牌。

  4. 生成邀请链接

    在 OAuth2 URL Generator 中添加 botapplications.commands 权限,生成邀请链接并添加到你的服务器。

  5. 配置 MushroomAgent

    设置环境变量或配置文件启用 Discord channel。

配置

channels:
discord:
enabled: true
bot_token: "xxx"

环境变量:

  • DISCORD_BOT_TOKEN

权限要求

机器人至少需要以下权限:

General Permissions:

  • View Channels

Text Permissions:

  • Send Messages
  • Read Message History
  • Embed Links
  • Attach Files

适用场景

  • 社区机器人
  • 开发者支持频道
  • Discord 私聊或频道内的 agent 助手