Hermes Agent 快速入门：从安装到第一步

为什么值得关注 Hermes

如果你曾经安装过一款新的 AI 工具，看着二进制文件落入你的 PATH，却最终得到一个技术上存在但实际上毫无用处的东西，你就已经理解了这个 Hermes Agent 快速入门所要解决的问题。安装完成只能证明文件被复制了，并不能证明 agent 能够检查代码库、与真实模型通信、安全地使用工具，或者在之后继续之前的工作。

这就是为什么 Hermes 值得关注。当它正常运行时，它不再像”终端里的 ChatGPT”，而是开始表现得像一个可操作的 agent。它可以检查文件、使用终端工具、保持在工作区内，并延续会话，而不是把每个提示都当作从零开始。

这使它非常适合开发者、自托管用户和以终端为主的用户，他们希望获得真实任务的帮助：总结代码库、在个人机器上检查代码库，或者在 AlexHost、AvaHost 或任何其他提供商的小型 VPS 上运行，而无需直接跳入更大的自动化栈。在本指南结束时，你将完成 Hermes 的安装、配置、在安全的首个任务上测试，并成功恢复会话。

Hermes 是什么——以及本指南实际上会帮你做什么

在运行任何命令之前，请区分清楚三个术语。大多数首次运行的困惑都来自于将它们混为一个模糊的”AI”概念。

下表为你提供了本教程的工作思维模型：

本文只针对一个成功状态：一个安全、可运行的 Hermes 会话，你可以启动、测试并恢复它。这不是生产部署指南，也不是完整的功能介绍。这是通往”Hermes 在我的机器上可以运行，并且我能证明它”的最短可靠路径。

📝 注意：安装 Hermes 与配置 Hermes 不是同一件事。二进制文件可以存在，但在你运行 hermes model 并将其连接到 provider 和 model 之前，它仍然无法使用。

你可能会注意到官方文档也提供了 hermes setup。这是有效的，但本指南有意将安装与 hermes model 分开，以便你能清楚地看到大多数首次运行成功或失败的地方。为了可重现性，我们也优先使用经典 CLI，尽管 hermes –tui 存在并使用相同的底层会话。本快速入门不涉及：gateway 设置、cron、MCP、本地模型网络、多 provider 路由和生产加固。

在给予 Hermes shell 访问权限之前的安全规则

在测试任何具有终端访问权限的 agent 之前，请决定允许它在哪里出错。对于本文，这意味着非生产机器、VM、一次性代码库，或者至少是一个低风险工作区，在那里意外命令不会毁掉你的一天。

⚠️ 警告：在整个快速入门过程中，请保持审批处于默认安全模式，不要使用 –yolo。Hermes 在执行危险命令前会询问；这是一个安全功能，而不是无意义的摩擦。

在继续之前，请使用以下快速检查清单：

• 从低风险机器或工作区开始。
• 保持审批提示启用。
• 首次测试时避免使用个人生产代码库。
• 预期验证任务保持只读。
• 将 Docker 和 SSH 终端后端视为后续加固步骤，而非第一天的要求。

本指南中的第一个真实验证任务保持在 ~/.hermes/hermes-agent 内，这使演示与 Hermes 相关，同时避免涉及敏感项目。一旦基础 CLI 流程稳定，你可以使用 Docker 或远程后端进行更强的隔离。在最初的一小时内，安全且可检查比雄心勃勃更重要。

安装前：前提条件、支持的路径和一个 WSL2 注意事项

对于主流用户，支持的情况很简单：Linux、macOS 和 WSL2 是首先需要关注的路径。原生 Windows 存在，但仍处于早期测试阶段，因此如果你使用 Windows，实际建议仍然是 WSL2。

在 Ubuntu 24.04 或 WSL2 上，首先确保 git 和 curl 可用：

如果第二行返回你的发行版字符串以及两个工具的正常版本输出，则你的基础前提条件已就绪。在 macOS 上，等效检查通常只是在使用相同的 Hermes 安装程序之前确认 git –version 和 curl –version。

📝 注意：原生 Windows 仍处于早期测试阶段，因此如果你使用 Windows，请优先选择 WSL2。
💡 提示：在 WSL2 中，将 Hermes 和你的工作代码库保存在 ~ 下，而不是 /mnt/c，以避免较慢的 Git 操作和奇怪的文件权限行为。

好消息是，Hermes 不需要你先手动组装一个庞大的依赖栈。官方 git 安装程序会为你处理 uv、Python 3.11、Node.js 22、ripgrep 和 ffmpeg。在设置向导启动之前，你应该准备好的是一个 provider 账户，或者至少是一个经过测试的自定义端点计划。另外，选择至少具有 64K 上下文的模型：一旦 agent 开始同时携带文件上下文、工具输出和多步骤指令，较小的上下文窗口往往会崩溃。

使用官方一行命令安装 Hermes Agent

前提条件准备好后，按照文档说明运行官方安装程序：

这不仅仅是一个简单的安装步骤。Hermes 检测平台，准备所需的依赖项，然后立即继续进入首次运行设置流程。在上面的示例中，安装程序检测到 Linux，检查 uv，在需要时安装 Python 3.11，为浏览器工具准备 Node.js 22，并构建 Hermes 命令环境。

如果以 root 身份执行安装，你可能会看到诸如 /usr/local/bin/hermes、/usr/local/lib/hermes-agent 和 /root/.hermes/ 之类的路径。在普通用户安装中，预期在你自己的主目录下有相同的结构。

重要的细节是，一行安装程序现在会直接进入设置向导。换句话说，安装和首次运行配置是一个连续的流程。不要将软件包安装结束视为终点，因为在完成此设置向导之前，Hermes 实际上并不可用。

第一个决定是推理 provider。在本次运行中，选择了 OpenRouter，这是一个实用的首选，因为它通过一个 provider 账户提供对广泛模型目录的访问。如果你已经使用了不同的受支持 provider，请选择那个。

选择 provider 后，Hermes 会要求提供匹配的 API 密钥。在本示例中，这意味着 OPENROUTER_API_KEY。粘贴密钥，按 Enter，Hermes 会将其存储以供将来使用。

如果跳过此步骤，Hermes 可以完成安装，但尚未准备好进行真实的 agent 会话。你需要返回并在之后配置 provider。

保存密钥后，向导进入模型选择。在本次运行中，选择的模型是 deepseek/deepseek-v4-pro。这是一个有效的具体示例，但不是你唯一的选择：向导还允许你输入自定义模型名称，或者如果你在现有安装上重新运行设置，可以跳过并保留当前模型。

对于首次运行，实用规则很简单：选择一个你已知可以访问的模型，并确保它有足够的上下文用于真实的 agent 工作。Hermes 在提供至少 64K 上下文窗口的模型下更加可靠。较小的上下文窗口在小型测试中可能看起来没问题，但一旦工具输出、文件上下文和多步骤指令开始堆积，就会崩溃。

如果你以后想更改此选择，hermes model 仍然是重新运行 provider 和模型选择而无需重新安装任何内容的最快方式。

接下来，Hermes 询问你现在想要完成多少更广泛的设置。对于本快速入门，推荐选项是正确的：快速设置。

这使文章专注于关键路径：provider、model 以及使 Hermes 可用所需的最少周边选择。

下一个屏幕询问终端后端。对于首次运行，保持当前本地后端，以便 Hermes 直接在此机器上运行。Docker、SSH、Modal 和其他后端在之后很有用，但在你甚至还没有确认基础 CLI 工作流是否有效之前，它们会增加复杂性。

Hermes 然后提供消息平台设置。对于本快速入门，跳过它。这使指南专注于核心 CLI agent 流程，你可以稍后使用 hermes setup gateway 添加 Telegram、Discord 或其他消息路径。

向导完成后，Hermes 显示它存储重要文件的位置。

需要记住的主要区别很简单：config.yaml 保存非机密设置，.env 保存 API 密钥和其他机密，数据目录保存会话、日志和相关运行时状态。在此截图中，路径在 /root/.hermes/ 下，因为安装是以 root 身份完成的。在普通用户安装中，将这些路径读作 ~/.hermes/。

Hermes 然后打印简短的就绪摘要，包括你最可能首先使用的命令。

此时，Hermes 已安装并配置完成。下一步是在继续第一个真实任务之前验证环境是否健康：

hermes doctor 应该确认基础内容：没有活跃的安全公告、正常的 Python 环境以及所需的软件包存在。这是你在继续之前想要的干净成功信号。

如果 hermes 在新 shell 中还不可见，请重新加载你的 shell 并在继续之前验证命令路径。在 Bash 上，通常意味着 source ~/.bashrc；在 Zsh 上，source ~/.zshrc。如果需要，使用 command -v hermes 确认启动器。

Doctor 通过后，安装不仅仅是完成了——Hermes 现在实际上已经可以使用了。

运行你的第一个安全 agent 任务

现在 Hermes 已安装、配置并通过 hermes doctor 检查，你已准备好进行第一次真实演示。最安全的高信号首个工作区是你的 Hermes 主目录本身。在本次运行中，安装是以 root 身份完成的，因此该目录是 /root/.hermes。在普通用户安装中，同一位置将是 ~/.hermes。

进入该目录，确认你所在的位置，然后启动 Hermes：

这是一个很好的首个工作区，因为它已经存在，与你刚刚安装的工具直接相关，并且与将 agent 放入个人或生产代码库相比风险较低。启动屏幕本身也是一个有用的健全性检查：它显示 Hermes 正确启动、页脚中的活跃模型，以及 agent 已经可以看到其可用工具和捆绑技能的事实。

如果你更喜欢新界面，hermes –tui 仍然可用，但本指南优先使用经典 CLI，因为它更容易逐步重现，而且两个界面共享相同的会话。

当 Hermes 打开时，给它一个简单的只读提示，要求它检查当前工作区并识别入口点。在本示例中，提示明确指向 /root/.hermes，因为安装是以 root 身份执行的。在普通用户安装中，将其指向你自己的 ~/.hermes 目录。

使用以下提示：

Summarize this repo in 5 bullets and tell me what the main entrypoint is: ~/.hermes

这正是你想要的第一个任务：安全、可观察且易于验证。在上面的截图中，Hermes 不只是猜测。它开始读取具体文件，如 config.yaml、SOUL.md 和 .install_method，搜索与 Hermes 相关的文件，并检查已安装的启动器路径。这种可见的工具活动是 Hermes 表现得像 agent 而不是一次性聊天框的真实证明。

健康的结果应该返回一个与工作区相关的具体摘要和一个可检查的入口点。在本次运行中，Hermes 识别出安装在 /usr/local/bin/hermes 的命令包装器，解释它指向 Python CLI 入口点，并用五个要点总结周围的 Hermes 环境。

这就是要寻找的成功信号。答案是具体的，基于 Hermes 实际检查的文件，并且易于与你在磁盘上已经看到的内容进行健全性检查。不要将结果视为魔法——将摘要与可见的文件和目录布局进行比较。对于第一次演示，安全且可验证远比华而不实更好。

恢复会话并确认设置真正有效

当 Hermes 回答一次时，快速入门并未完成。当你确认会话可以恢复时，它才算完成。

使用下面的恢复命令；-c 是同一操作的简写形式：

预期结果是 Hermes 重新打开最近的会话，或者给你一个明显属于你刚刚运行的任务的摘要。这很重要，因为它证明 Hermes 不是在充当一次性聊天。它保持着一个你可以返回的持久工作会话。

在继续之前，使用这个简洁的成功检查清单：

• Hermes 已安装并验证
• Provider 已配置
• 首次回复正常
• 首个代码库任务已完成
• 会话已成功恢复

如果恢复不起作用，首先确保你使用的是相同的配置文件，然后使用 hermes sessions list 检查可用会话。一旦 hermes –continue 正常工作，你就拥有了本 Hermes Agent 教程旨在建立的完整基线。

基础工作流程稳定后接下来尝试什么

一旦基础聊天稳定，每次只添加一个新层。

💡 提示：抵制立即启用所有高级功能的冲动。先让一个干净的工作流程稳定，然后有意识地扩展。

以下是合理的下一步简短菜单：

• 如果你想在相同会话模型之上使用更新的终端界面，请尝试 hermes –tui。
• 如果你想在手动了解基础知识后使用更广泛的设置向导，请稍后运行 hermes setup。
• 如果你的下一个目标是消息平台集成，请探索 hermes gateway setup。
• 当你想要受控的能力扩展时，请查看 hermes tools 和 hermes skills。
• 如果 agent 将开始接触更高风险的系统，请迁移到 Docker 或 SSH 终端后端。
• 一旦托管路径已经正常工作，请使用官方文档了解自定义 provider 和本地模型端点。

如果你想要真实使用的后续想法，以下是一些值得研究的好建议：代码库入门笔记、变更日志起草、安全重构规划、配置文件说明、拉取请求审查摘要、VPS 维护清单、部署运行手册起草、日志分类提示和文档缺口发现。

对于更深入的路径，向外链接而不是将本快速入门延伸为第二篇文章：快速入门、安装文档、CLI 指南和安全指南是正确的下一站。

你现在拥有了一个安全可用的 Hermes 快速入门

重要的里程碑不是 Hermes 安装了。重要的里程碑是 Hermes 变得有用了。你现在拥有了一个经过验证的基线：二进制文件存在，provider 已配置，首次回复正常，首个安全任务已完成，会话之后已恢复。

这是停下来庆祝成功的正确时机。保持审批开启，每次扩展一层，当 agent 开始执行更高风险的工作时，向更强的隔离迈进。如果你最终在个人工作站、实验室机器或 AlexHost、AvaHost 或其他任何地方的 VPS 上运行 Hermes，规则保持不变：以小步骤赢得信任。