跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Discord 机器人创建与配置完整流程

Discord 机器人创建涉及开发者门户应用注册、Bot 用户添加、特权意图开启、Token 获取及 OAuth2 邀请链接生成。关键步骤包括配置 Message Content Intent 以读取消息文本,设置服务器角色权限确保 Bot 可访问频道,以及安全存储 Token 避免泄露。生产环境需注意速率限制与审核要求,通过环境变量管理密钥并验证权限配置以解决常见 403 错误或消息读取失败问题。

www发布于 2026/3/21更新于 2026/9/983 浏览

主要步骤概览

  1. 在 Discord Developer Portal 创建应用(Application)
  2. 在应用中创建 Bot(Bot User)
  3. 开启必要的权限与 Privileged Intents(特别是 Message Content Intent)
  4. 生成邀请链接并把 Bot 邀请进你的服务器
  5. 获取 Bot Token 并妥善保存(放到环境变量)
  6. (可选)在服务器/频道设置权限,确认 Bot 可以读取消息历史与附件
  7. 用 Python 运行最小测试脚本,确认能接收到消息并处理附件

详细步骤

1. 创建应用(Application)

  • 打开:https://discord.com/developers/applications
  • 点击 'New Application',填名称(例如:MyForwarderBot),点击创建。

2. 在应用中创建 Bot

  • 左侧选择 'Bot' 标签页。
  • 点击 'Add Bot' → 'Yes, do it'。
  • 这会创建一个 Bot 用户;你可以修改头像、名字等。

3. 开启 Privileged Gateway Intents(非常重要)

  • 在 Bot 页面往下找到 'Privileged Gateway Intents' 部分:
    • 打开 'Message Content Intent'(允许读取 message.content)。(你需要开启它才能通过 SDK/库读取普通消息文本)
    • 若你需要成员列表或 presence,也可按需打开 'Server Members Intent' 或 'Presence Intent'。
  • 注意:如果你的 Bot 要加入 100+ 服务器,启用某些特权 intents 可能需要经过 Discord 的审核/验证。

4. 获取 Bot Token(千万别泄露)

  • 在 Bot 页面中,点击 'Reset Token' 或 'Copy' 获取 Bot 的 token(例如 'Bot XXXXXXXXX…')。把它存到安全地方(本地 .env 或服务器环境变量)。
  • 如果 token 泄露,立即在同一页面重置(Regenerate)。

5. 生成邀请链接并邀请 Bot 到你的服务器

  • 在左侧选 'OAuth2' → 'URL Generator'。
    • Scopes: 勾选 'bot' (如需 slash commands 也勾 'applications.commands')。
    • Bot Permissions: 在这里勾选所需权限(建议至少勾选):
      • View Channels (Read/View Channels)
      • Read Message History
      • Send Messages
      • Embed Links
      • Attach Files (如需上传)
      • Manage Messages(可选)
    • 页面底部会生成一个邀请链接(URL)。
  • 复制该 URL,在浏览器打开并选择要把 Bot 添加到的服务器(你必须拥有该服务器的管理权限或有邀请权限)。

说明:不要手动猜 permissions 的整数值 — 用 OAuth2 页面勾选更安全。也可用手动构造: https://discord.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot%20applications.commands&permissions=PERMISSIONS_INTEGER 但推荐用页面生成器以避免权限错误。

6. 在目标服务器确认 Bot 权限

  • 在服务器的角色设置中,确认 Bot 的角色拥有'View Channels'与'Read Message History'权限;在频道覆盖权限中也要允许读取消息。
  • 若 Bot 无法读取 message.content,要检查是否已在开发者面板开启 Message Content Intent 并且你的代码在使用相应的 intents(见下例)。

7. 获取频道 ID(如需按频道过滤)

  • 在 Discord 客户端设置 → 高级 → 打开 '开发者模式'。
  • 右键频道或消息 → 选择 'Copy ID' 得到 channel id(用于脚本过滤/配置)。

8. 安全与生产建议

  • 切勿把 token 写入代码库。用环境变量或秘密管理工具(.env 文件在部署时放到服务器,且不要提交到 git)。
  • 如果 token 泄露,立即在开发者面板重置。
  • 在生产环境启用适当的日志、错误重试和速率限制处理(Discord API 接口都有限流)。
  • 如果 Bot 要加入很多服务器(100+),注意 Discord 的验证/审核要求。

常见问题与解决

  • 读不到 message.content:确认你在开发者页面开启了 Message Content Intent,并在代码里把 intents.message_content = True。
  • 403 或权限错误:确认 Bot 在服务器的角色/频道中有'View Channel'和'Read Message History'的权限,以及你在 OAuth2 页面勾选了正确权限。
  • 邀请失败(没有权限):邀请者必须在目标服务器有'管理服务器'或相应权限。

目录

  1. 主要步骤概览
  2. 详细步骤
  3. 1. 创建应用(Application)
  4. 2. 在应用中创建 Bot
  5. 3. 开启 Privileged Gateway Intents(非常重要)
  6. 4. 获取 Bot Token(千万别泄露)
  7. 5. 生成邀请链接并邀请 Bot 到你的服务器
  8. 6. 在目标服务器确认 Bot 权限
  9. 7. 获取频道 ID(如需按频道过滤)
  10. 8. 安全与生产建议
  11. 常见问题与解决

更多推荐文章

查看全部
  • Trae AI 辅助编程实战指南:从入门到提效
  • AI 中的 Skills 详解:核心机制与场景应用
  • 小米温湿度计智能家居改造:ATC 固件刷写与 HA 集成
  • AIGC 技术在元宇宙与虚拟世界中的应用
  • 大厂 AI 人才争夺战:哪些技术职位最火爆?
  • AI 自动化测试:接口测试全流程自动化实现方法
  • 前端开发必备:配色、素材与图标资源站精选
  • OpenHarmony 开发:使用 cached_query 实现高性能声明式数据缓存
  • C 语言快速排序详解与优化实现
  • Shell 脚本中 date 命令常用技巧与实战
  • Go Cron 定时任务
  • Windows 系统快速部署 llama-cpp-python 实现 AI 模型本地推理
  • VR 与 AR 技术深度解析:从原理到未来趋势
  • 人脸识别安全审计:基于 RetinaFace 与 CurricularFace 构建测试环境
  • GitHub 核心概念与开发协作指南
  • IDEA 插件开发:Swing 图形界面设计指南
  • CentOS 系统定时执行 Python 邮件发送的五种方案
  • Rust WebAssembly 与 Three.js 结合的高性能粒子系统实战
  • SQLAlchemy 核心用法与实战案例解析
  • Python 技术生态全景:Web 开发、数据科学与自动化实战

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online