需依次启用discord网关并配置bot token、设置频道白名单与会话隔离、注册游戏技能并同步slash command、启用whisper语音转文字、配置角色权限映射，方可使hermes agent作为游戏社区ai助手在discord正常运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将Hermes Agent作为游戏社区AI助手接入Discord，但发现消息无响应、指令不执行或Bot无法加入服务器，则可能是由于Discord网关未启用、Bot Token配置错误、权限缺失或会话隔离未适配频道结构所致。以下是完成Discord集成并支撑游戏社区场景运行的具体步骤：
一、启用Discord网关并注入有效Bot Token
此步骤确保Hermes Agent底层通信模块加载Discord事件监听器，并通过合法凭证建立与Discord API的稳定连接。未启用网关将导致所有消息事件被静默丢弃，Bot在Discord中显示为离线或无响应。
1、打开终端，进入Hermes Agent安装目录所在路径。
2、执行命令查看当前已启用的网关：hermes gateway list。
3、若输出中不含discord，运行命令启用：hermes gateway enable discord。
4、访问discord.com/developers，创建新应用，进入Bot设置页，开启MESSAGE CONTENT INTENT开关，并复制生成的Bot Token。
5、在终端中执行配置命令：hermes config discord --token YOUR_DISCORD_BOT_TOKEN，请务必将YOUR_DISCORD_BOT_TOKEN替换为实际Token值。
二、配置游戏频道白名单与上下文隔离策略
游戏社区通常包含公告频道、组队频道、语音频道、攻略频道等多类型分区，需通过显式声明允许交互的频道ID及启用隔离机制，防止跨频道指令污染、用户数据混淆或误触发敏感操作。
1、编辑Hermes主配置文件：~/.hermes/config.yaml。
2、在gateways: discord:节点下添加字段：allowed_channels: ["123456789012345678", "876543210987654321"]，其中每个ID须通过Discord客户端右键对应频道→“复制ID”获取（需提前启用开发者模式）。
3、添加配置项：session_isolation_by_platform: true与session_isolation_by_channel: true，确保不同频道间会话状态完全独立。
4、保存文件后重启服务：hermes restart。
三、部署游戏专属技能并绑定Discord Slash Command
Discord原生支持Slash Command（斜杠指令），可将Hermes Agent封装为可发现、可授权、带参数提示的交互入口，适用于查询服务器状态、匹配队友、检索攻略、登记战报等高频游戏场景。
1、在Hermes项目根目录下创建技能文件夹：skills/game/，并在其中新建server_status.py，定义函数接收region参数并返回实时在线人数。
2、运行命令注册该技能：hermes skill register game/server_status.py。
3、执行命令同步Slash Command到Discord：hermes discord sync-commands。
4、在Discord中任意已授权频道输入/server-status region:asia，即可触发执行并返回结构化结果。
四、启用语音转文字支持以处理游戏内语音消息
游戏社区常通过语音频道快速协调战术、复盘对局，需将语音消息自动转录为文本后交由Agent理解与响应。该能力依赖Whisper本地推理模块与Discord音频事件网关联动。
1、确认系统已安装FFmpeg：运行ffmpeg -version，若报错则按官方文档安装。
2、下载Whisper小模型权重：hermes whisper download tiny.en。
3、编辑~/.hermes/config.yaml，在gateways: discord:下添加：enable_voice_transcription: true与whisper_model: tiny.en。
4、重启Agent：hermes restart；随后在Discord语音频道上传.ogg格式语音片段，Hermes将自动转录并响应。
五、配置角色权限与安全审批链以适配社区治理需求
游戏社区存在管理员、版主、普通成员等多级身份，需限制高危操作（如踢人、封禁、执行shell命令）仅对具备特定Discord角色的用户开放，避免误操作引发治理风险。
1、在Discord服务器设置中，为管理员角色分配Manage Roles与Kick Members权限。
2、编辑~/.hermes/config.yaml，添加权限映射规则：role_permissions_map: {"Admin": ["kick", "ban", "shell"]}。
3、在技能代码中调用context.check_permission("kick")进行运行时校验。
4、重启服务使策略生效。
