discord bot 配置有四种路径：一、通过 developer portal 手动创建 bot 并开启三项 privileged intents，复制 token 后运行 hermes setup 输入；二、执行 hermes discord setup 一键初始化并填写 id 信息；三、通过环境变量 discord_bot_token 等注入配置；四、用 oauth2 url 将 bot 加入服务器并授予权限，最后验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的本地安装，但尚未将其接入 Discord 平台以实现社群自动响应与互动，则问题核心在于 Discord Bot 的创建、权限配置及 Hermes 端的参数对接。以下是完成该配置的多种可行路径：
一、通过 Discord Developer Portal 手动配置 Bot
此方法适用于需精细控制 Bot 权限、意图（Intents）及事件监听范围的用户，确保 Hermes 能准确接收消息、解析指令并触发响应。
1、访问 Discord Developer Portal，登录您的 Discord 账号。
2、点击右上角“New Application”，输入应用名称（如 Hermes-Agent-Discord），创建新应用。
3、在左侧菜单中选择“Bot”，点击“Add Bot”，确认创建。
4、在 Bot 设置页中，开启三项 Privileged Gateway Intents：MESSAGE CONTENT INTENT、SERVER MEMBERS INTENT、PRESENCE INTENT，并点击 Save Changes。
5、复制页面中显示的 Bot Token，该 Token 将用于 Hermes 初始化配置阶段。
6、返回 Hermes 安装目录，在终端执行 hermes setup，当提示输入 Discord Token 时，粘贴上述复制的 Token。
二、使用 hermes discord setup 命令一键初始化
此方法调用 Hermes 内置的 Discord 配置向导，自动处理环境变量写入与基础网关注册，适合快速验证部署效果。
1、确保已激活 Hermes 虚拟环境：source ~/.hermes/venv/bin/activate。
2、运行专用命令：hermes discord setup。
3、按提示依次输入：Discord Bot Token、目标服务器（Guild）ID、默认频道（Channel）ID。
4、命令执行完成后，Hermes 将自动生成 .env.discord 配置文件，并启动 Discord 消息网关服务。
5、验证是否生效：在指定 Discord 频道中发送任意消息，观察 Hermes 终端日志是否输出 [DISCORD] Received message 日志行。
三、通过环境变量注入方式配置（适用于云部署或容器化场景）
此方法绕过交互式 setup 流程，直接将凭证与参数注入运行时环境，便于 CI/CD 流水线集成或 Docker 容器启动。
1、准备以下环境变量值：DISCORD_BOT_TOKEN（必填）、DISCORD_GUILD_ID（可选，用于限制监听范围）、DISCORD_CHANNEL_ID（可选，用于定向推送）。
2、在 Hermes 启动前，执行：export DISCORD_BOT_TOKEN="your_token_here"。
3、若使用 systemd 或 Docker，需将变量写入服务定义文件或 docker run -e 参数中。
4、启动 Hermes：hermes start，系统将自动读取环境变量并加载 Discord 网关模块。
5、检查进程日志中是否出现 Discord gateway connected successfully 字样，确认连接建立。
四、验证机器人在 Discord 中的实际表现
配置完成后，需在 Discord 服务器中完成 Bot 的实际加入与权限赋予，否则 Hermes 无法接收到任何事件。
1、在 Developer Portal 的“OAuth2” → “URL Generator” 页面，勾选 bot 和 applications.commands 范围。
2、在“Bot Permissions”区域，勾选所需权限，至少包括：Send Messages、Read Message History、Use Slash Commands。
3、生成 OAuth2 URL 并在浏览器中打开，选择目标服务器，点击“Authorize”完成 Bot 加入。
4、进入服务器设置 → “成员”，确认 Bot 状态为在线且无禁言标识。
5、在任意文本频道中输入 /help 或 @HermesAgent ping，观察是否获得即时响应。
