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

主要步骤概览

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'权限；在频道覆盖权限中也要允许读取消息。