Hermes Agent 通过单个命令安装，并在 Linux、macOS 或 WSL2 上运行。但安装只是简单部分——“它能运行”和“它能随着时间真正改进”之间的区别在于配置。大多数认为 Hermes 表现平平的用户从未启用使其与众不同的功能。
本指南涵盖从首次安装到第一个自动化任务的一切，包括大多数教程跳过的配置步骤。
关键要点
安装只需 2 分钟。配置需 15 分钟。大多数人忽略的关键步骤：在配置中启用 persistent_memory 和 skill_generation。没有这些，Hermes 的行为就像任何其他单会话代理一样。
安装前需要什么？
几乎什么都不需要。Hermes 的安装程序会自动处理依赖项。你需要：
| 要求 | 详情 |
|---|---|
| 操作系统 | Linux、macOS 或安装了 WSL2 的 Windows |
| LLM API Key | 至少一个：Anthropic (Claude)、OpenAI (GPT)、Google (Gemini) 或 OpenRouter |
| 硬件 | 任何现代设备。全天候运行：每月 5-10 美元的 VPS 就足够了 |
| 终端访问 | 基本的命令行熟悉度 |
如何安装 Hermes Agent？
步骤 1：运行安装程序。
这会下载并设置所有内容 — Node.js、Python 依赖、SQLite 和 Hermes 运行时。根据你的连接速度，需要 1-3 分钟。
步骤 2：配置你的 LLM 提供商。
安装完成后，Hermes 会询问使用哪个 LLM 提供商。最常见的选项：
📋 提供商配置示例
# 用于 Claude（最佳质量，成本较高） provider: anthropic model: claude-sonnet-4-20250514 api_key: sk-ant-... # 用于 GPT（良好平衡） provider: openai model: gpt-5.4 api_key: sk-... # 用于预算配置（通过 OpenRouter 免费） provider: openrouter model: qwen/qwen-3.5 api_key: sk-or-...
社区对模型的共识：开启中等+ 思考模式的 GPT 5.4 是最受欢迎的日常驱动器。OpenRouter 上的 Qwen 3.5 免费且足以应对常规自动化。Claude Opus 产生最佳质量，但成本显著更高 — 而且 Anthropic 一直在限制第三方重度使用。
步骤 3：启用重要的功能。
这是大多数教程失败的地方。打开你的 Hermes 配置文件并启用这两个设置：
没有这些，Hermes 在会话间会忘记一切，也不会创建可重用技能。它就只是另一个聊天机器人包装器。启用它们后，每个复杂任务（5+ 工具调用）会自动创建一个技能文件，所有对话可在会话间搜索。
---📬 从中获得价值了吗？ 我们每周发布 AI 工具和工作流指南。订阅到你的收件箱 →
---如何运行你的第一个任务？
在终端中启动 Hermes：
你现在处于交互式会话中。尝试这些入门任务来验证一切正常运行：
测试基本对话： “你能帮我做什么？” — 验证 LLM 连接是否正常。
测试网络搜索： “搜索 Nous Research 的最新新闻，并用 3 个要点总结。” — 验证工具调用是否正常。
测试技能创建： “研究 2026 年排名前 5 的 AI 代理框架，比较它们的功能，并撰写一份总结报告。” — 这应该触发 5+ 次工具调用，完成后 Hermes 会自动创建一个技能文件。检查你的 skills 目录以验证文件是否已创建。
测试记忆： 关闭会话，启动一个新会话，然后问 “上次我们讨论了什么？” 如果持久化记忆正常工作，Hermes 会回忆起之前的对话。
如何连接消息平台？
Hermes 支持 Discord、Telegram、Slack、Microsoft Teams 等多个平台。每种平台都需要创建机器人令牌并将其添加到配置中。以 Discord 为例：
1. 在 discord.com/developers/applications 创建 Discord 机器人
2. 复制机器人令牌
3. 添加到你的 Hermes 配置中：
4. 重启 Hermes。你的机器人在 Discord 服务器中出现，准备好响应。
相同的模式适用于 Telegram（BotFather 令牌）、Slack（应用 OAuth 令牌）和其他平台。Hermes v0.10.0 添加了 Microsoft Teams 作为插件发货的平台，并总共支持 18+ 个消息平台。
如何为多种用例设置配置文件？
Hermes v0.6.0 引入了配置文件 — 独立的实例，具有独立的配置、记忆、技能和网关连接。这让你可以运行一个带有 Slack 集成的“工作”配置文件，以及一个带有 Telegram 的“个人”配置文件，每个配置文件都有自己的记忆和学习到的技能。
最常见的设置错误有哪些？
| 错误 | 症状 | 修复方法 |
|---|---|---|
| persistent_memory not enabled | 代理在会话间忘记一切 | 在 config 中设置 persistent_memory: true |
| skill_generation not enabled | 复杂任务后未创建技能文件 | 在 config 中设置 skill_generation: true |
| Using low effort model settings | 输出质量感觉下降 | 将 effort 设置为 high 或 xhigh |
| Running on a public VPS without hardening | 安全暴露 | 启用容器隔离，只读根目录 |
| Not setting up checkpoint/rollback | 无法从代理错误中恢复 | 在 config 中启用文件系统检查点 |
要更全面地了解AI 代理的工作原理以及 Hermes 在生态系统中的位置，请参阅我们的完整指南。要获得与任何 AI 代理互动时更好的提示，请试用免费的Prompt Optimizer。
---📬 想要更多类似内容？ 实用的 AI 设置指南，每周一期。免费订阅 →
---常见问题解答
设置需要多长时间？
安装只需 2 分钟。基本 LLM 配置需 5 分钟。启用记忆、技能和消息集成再需 10-15 分钟。总计：不到 30 分钟即可获得完全功能的代理。
我能在 Raspberry Pi 上运行 Hermes Agent 吗？
技术上可以（它支持 Linux），但性能会受限。从 DigitalOcean 或 Hetzner 的每月 5-10 美元 VPS 能提供更好性能和全天候能力。
如果以后更换 LLM 提供商会怎样？
切换只需更改配置——无需修改代码。你的记忆、技能和对话历史都会保留。只有 LLM 响应的质量/风格会根据新模型变化。
我需要 Docker 吗？
不需要。标准安装不要求 Docker。Docker 是可选的，仅推荐用于生产部署以获得安全容器隔离。
披露：本文中某些链接为联盟链接。我们仅推荐我们亲自测试并定期使用的工具。查看我们的完整披露政策。