在 Hermes Agent 中嵌入 Discord：完整的机器人设置指南

架构：Discord 是前门，Hermes 是工人

在接触 Discord 开发者门户之前，了解心理模型会有所帮助。 Discord 不会取代 Hermes Agent。不和谐是界面。 Hermes 仍然是决定要做什么、记住先前上下文并执行实际任务的工人。

干净的 Hermes Discord 设置有四层。第一层是 Discord 本身：应用程序、机器人用户、OAuth 安装链接、网关事件、通道权限和斜线命令。第二层是 Hermes Gateway：接收 Discord 消息并将其映射到会话的进程。第三层是Hermes Agent执行：模型选择、工具使用、文件处理、内存、终端后端。第四层是传递：返回给 Discord 的响应、文件、摘要或状态消息。

这种分层视图可以防止常见的错误。当机器人没有回答时，用户通常会认为模型已损坏。实际上，问题通常是以下三件事之一：Discord 无法向机器人发送消息内容、机器人没有足够的服务器权限，或者 Hermes 由于 Discord 用户 ID 未授权而拒绝用户。

第1步：在创建机器人之前准备Hermes代理

首先确保 Hermes Agent 已安装、配置有推理提供程序，并且能够在本地或网关保持在线的服务器上运行。仅当 Hermes Gateway 进程正在运行时，Discord 才有用。如果机器处于睡眠状态，机器人可能会显示不可用或停止响应。

对于本地个人设置，在台式机或笔记本电脑上运行 Hermes 就可以进行测试。对于严肃的团队设置，VPS、云虚拟机或持久工作站通常更好。重要的决定是 Hermes 命令将在哪里执行。本地后端很方便，但隔离性较差。对于需要大量工具的任务，Docker 或远程后端更安全，特别是当机器人处理文件或执行脚本时。

在连接 Discord 之前，直接从 CLI 测试 Hermes。问它一个简单的问题，然后让它执行一个基于工具的小任务。如果基础代理不起作用，Discord 只会使调试变得更加困难。

第 2 步：创建 Discord 应用程序

转到 Discord 开发者门户并创建一个新应用程序。给它一个明确的名称，例如“赫尔墨斯特工”、“赫尔墨斯研究中心”或“支持特工”。该名称应反映其角色，因为用户将在服务器成员列表中看到它，并且根据配置，在消息和线程中看到它。

创建应用程序后，记下“常规信息”页面中的应用程序 ID。手动生成邀请 URL 时使用此 ID。即使您使用 Discord 的安装选项卡，也请将 ID 放在手边，因为它对于调试和文档很有用。

这也是决定这个机器人是个人的、仅限团队的还是面向公众的好时机。个人机器人可能是狭隘且宽容的，因为只有一个用户与其交互。团队机器人需要更强大的基于角色的访问。公共社区机器人应该被视为几乎像生产服务一样：最低特权权限、严格的通道范围、明确的速率限制以及默认情况下没有敏感工具访问权限。

步骤 3：创建 Bot 用户并保护令牌

在应用程序内，打开机器人部分。 Discord 为应用程序创建一个机器人用户。该机器人用户是 Hermes 连接到 Discord 时将使用的身份。您可以设置头像和显示名称，这听起来很装饰，但会影响采用。支持服务器中名为“Hermes Support”的机器人比通用的“AI Bot”更清晰。

如果您想使用 Discord 的标准安装链接，请保持公共机器人处于启用状态。对于正常的 Hermes 机器人流程，请禁用“需要 OAuth2 代码授予”。如果您想要一个私人机器人，您可以将其保持私密，但您将需要使用手动邀请 URL，而不是依赖 Discord 提供的安装流程。

然后生成或重置机器人令牌。将此令牌视为密码。任何拥有它的人都可以控制机器人。请勿将其粘贴到屏幕截图、GitHub 问题、公共配置文件、Discord 消息或共享文档中。将其存储在密码管理器中或可信计算机上的 Hermes .env 文件中。实用的规则很简单：如果令牌接触到公共场所，请立即重置它。

第 4 步：启用正确的网关意图

网关意图是 Discord AI 机器人失败的最常见原因之一。如果机器人在线但没有响应，通常首先要检查消息内容访问。

对于 Hermes Agent，启用 消息内容意图 这样机器人就可以读取用户发送的文本。如果您计划通过 ID 授权用户、解析用户名或使用基于角色的控制，请启用服务器成员意图。状态意图通常是可选的，并且应保持关闭状态，除非有特定原因需要跟踪在线状态。

这很重要，因为 Discord 有意限制机器人可以看到的内容。从安全和隐私的角度来看，这很好。从设置的角度来看，它创建了一种静默故障模式：机器人收到事件，但实际消息内容可能为空。 Hermes 无法对它无法读取的消息进行推理。

如果您的机器人位于少量服务器中，则通常只需在开发人员门户中进行切换即可。如果它发展到许多服务器，Discord 可能需要对特权意图进行额外的验证。对于个人或内部 Hermes 设置，这通常不是问题，但在设计公共机器人策略之前值得了解。

第 5 步：生成 OAuth 邀请链接

机器人需要通过 OAuth 被邀请到 Discord 服务器。标准范围是 bot 和 applications.commands。第一个将机器人用户添加到服务器。第二个启用应用程序命令，例如斜杠命令。

权限应该是具体的。对于正常的 Hermes Agent Discord 设置，有用的权限包括查看频道、发送消息、读取消息历史记录、嵌入链接、附加文件、在线程中发送消息以及添加反应。除非您有狭隘的内部原因并且完全信任环境，否则不要请求管理员权限。

Hermes文档提供了推荐的权限整数，但更深层的一点是权限设计。如果机器人仅在一个支持渠道中运行，请将其限制在该渠道。如果它将处理上传的文件，则仅在需要时允许附件。如果它将生成报告，请决定这些报告是否应该公开出现或出现在私人家庭频道中。

生成链接后，打开它，选择服务器，并对机器人进行授权。您需要管理服务器权限才能执行此操作。授权后，机器人应出现在成员列表中。在 Hermes Gateway 启动之前，它可能会保持离线状态。

第 6 步：找到您的 Discord 用户 ID

Hermes 不应该默认回答所有人。更安全的方法是准确定义谁可以与其交互。为此，您需要您的 Discord 用户 ID。

在 Discord 中，在“设置”下启用开发者模式，然后右键单击您的用户名并复制您的用户 ID。这是一个长数字 ID。它比显示名称更可靠，因为名称和昵称可以更改。

对于团队设置，您可以授权多个用户 ID 或使用允许的角色 ID。基于角色的访问对于审核团队、支持团队和工程团队来说更容易，因为访问遵循 Discord 角色。当有人离开团队时，删除角色会删除机器人访问权限，而无需编辑 Hermes 配置。

这是很多球队应该放慢脚步的地方。 Hermes 代理机器人可以访问工具、内存、文件，或许还可以访问本地命令执行。这很有用，但这也意味着访问控制不是一种形式。像对待内部自动化系统的访问一样对待机器人访问。

步骤7：配置Hermes网关

最简单的方法是运行引导设置：hermes gateway setup。出现提示时选择 Discord，然后粘贴机器人令牌和您的 Discord 用户 ID。 Hermes 会将所需的值写入其配置中。

对于手动设置，请添加到 ~/.hermes/.env：DISCORD_BOT_TOKEN=your-bot-token 和 DISCORD_ALLOWED_USERS=your-discord-user-id。对于多个用户，用逗号分隔 ID。然后启动网关：hermes gateway。

几秒钟之内，机器人就会上线。先直接发消息给它。 DM 是最干净的测试，因为通道权限问题较少。之后，通过提及机器人在服务器通道中测试它。

第 8 步：了解 DM、提及、话题和自由回复渠道

一个行为良好的 Discord 特工不应该介入每一次对话。 Hermes 通过在 DM、服务器通道、线程和配置的自由响应通道中使用不同的行为来处理此问题。

在直接消息中，Hermes 会回复每条消息，因为对话显然是针对机器人的。在服务器通道中，更安全的默认设置是 Hermes 仅在提及时做出响应。这可以防止机器人打断人类对话或销毁原本不适合它的消息上的令牌。

线程对于代理工作特别有用。用户可以在频道中提及 Hermes，然后在线程中继续关注的任务。这可以保持主通道的干净并为任务提供专用的上下文。对于支持社区来说，这很有价值，因为一次长时间的诊断对话不会淹没主支持室。

免费回复渠道有所不同。这些是用户可以与 Hermes 交谈而无需每次提及的渠道。像 #ask-hermes、#ai-lab 或 #research-desk 这样的通道可以很好地作为自由响应空间。但是，除非您对机器人的广泛反应感到满意，否则请避免在整个活动服务器上启用自由响应。

步骤 9：为真实团队配置会话隔离

会话隔离是 Hermes Discord 最重要的设置之一，因为 Discord 频道是共享空间。默认情况下，Hermes 可以在共享通道内保持每个用户的会话隔离。这意味着 Alice 和 Bob 都可以在 #research 中与 Hermes 交谈，而无需自动共享相同的对话历史记录。

这种默认设置更安全并且通常更便宜。它可以防止一个用户的长期工具密集型任务使另一用户的上下文变得臃肿。当两个人同时问不同的问题时，它还可以减少干扰问题。

共享会话仍然有用。例如，一个小型工程团队可能会创建一个 #incident-room，其中每个人都希望 Hermes 理解相同的实时调试上下文。在这种情况下，共享的房间环境就很有价值。但这应该是一个深思熟虑的选择，而不是偶然。

对于大多数团队来说，最好的模式是在通用渠道中进行隔离会话、仅在专门构建的协作室中进行共享会话以及针对个人任务进行 DM。

第10步：仔细添加斜线命令

斜线命令让机器人感觉是 Discord 原生的。它们对于可预测的操作非常有用，例如开始新任务、总结通道、检查状态或将输出发送到主通道。

重要的限制是时间。不和谐的互动需要快速的初步反应。如果命令触发较长的 Hermes 工作流程，机器人应首先确认该命令，然后在任务完成时发送后续命令。否则，即使代理仍在工作，用户也可能会看到“应用程序未响应”消息。

对于 Hermes Agent，斜线命令应该围绕任务控制而不是长篇散文输入来设计。好的斜杠命令可能是 /summarize_thread、/new_task、/status 或 /forget_session。对于开放式任务，普通消息通常更好，因为用户可以自然地解释上下文。

Discord 作为人工智能运营室

考虑一个在 Discord 上运行测试社区的小型 SaaS 团队。用户在 #support 中报告错误，高级用户在 #feedback 中讨论功能，内部团队使用私有 #ops 通道。

嵌入 Hermes 后，团队可以创建受控的工作流程。在 #support 中，Hermes 仅在提及时做出响应，帮助总结错误报告并起草故障排除步骤。在 #feedback 中，它可以总结每周主题，而无需回复每条消息。在私人 #ops 中，授权团队成员可以要求 Hermes 将当天的问题转化为发行说明草稿或优先修复列表。

这并不是一个幻想的“人工智能取代团队”的设置。有价值的部分更小、更实用：不和谐的对话不再消失。它们变成了结构化的摘要、任务、后续行动和可重用的记忆。该代理没有用，因为它会聊天。它很有用，因为它将混乱的对话转换为可操作的输出。

类似的模式也适用于开发者社区。维护人员可以要求 Hermes 总结重复的问题、从线程中提取重现步骤或起草文档补丁。人类仍然会审查结果，但从聊天混乱到结构化工作的重复转换变得更快。

一些用户希望通过聊天应用程序获得代理执行的功能，但不想花太多时间管理本地运行时详细信息、环境设置或通道连接。这就是 EasyClaw 可以自然融入对话的地方。它的定位是从熟悉的聊天应用程序（包括 Discord）运行人工智能代理任务，同时保持实际工作与桌面或托管环境连接。对于喜欢 Discord 优先工作流程但想要更多引导设置体验的团队来说，它可以减少“我想要聊天中的代理”和“代理实际上正在执行任务并返回结果”之间的摩擦。

生产中重要的安全规则

Hermes Discord 机器人的最大风险并不是模型给出的答案很弱。这是机器人拥有的访问权限超出了频道应有的权限。

从最低权限开始。仅授予机器人所需的权限。将其限制在特定渠道。使用允许的用户或角色。不要让公共社区成员触发文件系统操作、代码执行、私人数据检索或外部帐户操作。

尽可能将个人机器人和团队机器人分开。个人 Hermes 实例可能知道私人偏好、本地文件或个人工作流程。团队 Hermes 实例应该具有不同的内存边界和不同的工具边界。将两者混合会产生本可以避免的混乱。

小心附件。如果用户可以上传文件供机器人处理，请决定大小限制、文件类型、保留行为以及输出是否应公开。支持日志、发票或 API 密钥屏幕截图可以轻松显示在 Discord 附件中。

最后，记录服务器中的机器人行为。用户应该知道机器人何时响应、它可以访问什么、允许谁使用它以及如何停止或升级任务。明确的期望可以降低安全风险和用户的挫败感。

故障排除：为什么机器人没有响应

如果机器人显示为离线，请检查 hermes gateway 是否正在运行。 Discord 机器人依赖于网关进程。如果进程停止，机器人将无法响应。

如果机器人在线但静默，请先检查消息内容意图。然后检查机器人是否有权限查看和发送该频道中的消息。接下来，检查用户是否包含在 DISCORD_ALLOWED_USERS 中或具有允许的角色。

如果机器人在 DM 中响应，但不在服务器通道中响应，则问题可能是提及行为或通道权限。直接提及机器人。如果可行，仅当您确实想要免提及交互时才配置自由响应渠道。

如果斜杠命令失败或超时，请重新设计它们以快速确认并稍后完成工作。长代理任务不适合同步命令响应模式。

如果机器人响应过于频繁，请收紧 require_mention、删除自由响应通道或将其隔离到特定房间。 Discord 中一个好的人工智能代理应该让人感觉可用，而不是侵入性的。

最后的想法：Discord 正在成为代理控制层

在 Hermes Agent 中嵌入 Discord 不仅仅是一个机器人设置练习。这是更广泛转变的一部分：聊天平台正在成为自主工作的控制层。用户不想要另一个仪表板。用户想要描述上下文已存在的任务，然后在同一位置接收进度和输出。

一个强大的 Hermes Discord 设置可以归结为五个决定。正确创建机器人。启用正确的意图。使用最小的有用权限来邀请它。配置 Hermes Gateway 严格的用户或角色授权。围绕真实的人类行为设计频道和会议。

当这些部分处理得当时，Discord 就不仅仅是一个通知界面。它成为代理工作的实用界面：支持摘要、研究线索、文件分析、发布准备、社区运营和轻量级内部自动化。未来不是一个通用的人工智能聊天窗口。它是嵌入到已经发生决策、问题和混乱工作的地方的代理。