核心流程概览
搭建一个 Discord 机器人通常包含以下关键环节：先在开发者门户创建应用并绑定 Bot 用户，接着开启必要的网关意图（Intents），随后生成 OAuth2 邀请链接将 Bot 拉入服务器，最后获取 Token 并通过代码验证功能。其中，Message Content Intent 的开启是读取消息文本的前提，而 Token 的安全存储则是生产环境的底线。
详细实施步骤
1. 创建应用与 Bot 用户
访问 Discord 开发者门户，点击'New Application'输入名称（如 MyForwarderBot）。进入左侧菜单的'Bot'标签页，点击'Add Bot'确认创建。此时你可以自定义 Bot 的头像和显示名称。
2. 配置网关意图（Intents）
在 Bot 页面向下滚动找到'Privileged Gateway Intents'。若你需要读取消息内容，必须开启'Message Content Intent'。如果还需要获取成员列表或在线状态，可酌情开启'Server Members Intent'或'Presence Intent'。
注意：若 Bot 计划加入超过 100 个服务器，部分特权意图可能需要经过 Discord 的官方审核。
3. 获取并保护 Token
在 Bot 页面点击'Reset Token'或'Copy'获取凭证。切勿将其直接写入代码库，建议保存在本地 .env 文件或服务器环境变量中。一旦怀疑泄露，立即在此处重置。
4. 生成邀请链接
进入'OAuth2' → 'URL Generator'。勾选 bot 作用域，如需支持斜杠命令则额外勾选 applications.commands。在'Bot Permissions'中勾选所需权限，例如查看频道、读取历史、发送消息及附件等。页面底部会生成授权 URL，复制后在浏览器打开即可将 Bot 邀请至拥有管理权限的服务器。
5. 服务器权限确认
邀请成功后，检查服务器内的角色设置。确保 Bot 的角色拥有'View Channels'和'Read Message History'权限。如果在代码中已开启意图但仍无法读取消息，请再次核对此处配置。
6. 获取频道 ID
若需按特定频道过滤消息，可在客户端设置中开启'开发者模式'，右键点击频道或消息选择'复制 ID'。
安全与最佳实践
- Token 管理：永远不要提交 Token 到 Git 仓库，使用秘密管理工具。
- 限流处理：Discord API 有严格的速率限制，代码中应实现重试机制。
- 审核要求：大规模部署前留意 Discord 的合规性要求。
常见问题排查
- 读不到消息内容：检查开发者面板是否开启 Message Content Intent，且代码中
intents.message_content = True。 - 403 权限错误：确认 Bot 在服务器角色及频道覆盖权限中已获授权。
- 邀请失败：执行邀请操作的用户需具备'管理服务器'权限。
