1. 从“理解它是什么”到“真正跑起来”

在第一期中，我主要从整体定位上理解了 Hermes Agent：它不是一个单纯的聊天机器人，也不是只绑定在 IDE 上的代码助手，而是一个可以长期运行、具备记忆、工具调用、skills、自我改进和自动化能力的 AI Agent。

不过，对于这类 Agent 项目，只停留在概念层面是不够的。因为 Agent 的很多能力并不是靠文字介绍就能理解的，而是需要在真实运行过程中观察它如何对话、如何调用工具、如何保存配置、如何管理模型 provider，以及如何处理执行环境中的问题。

所以第二期的重点就是：把 Hermes Agent 在本地环境中安装起来，并完成第一次运行。

这一期不追求深入源码，而是先解决三个基础问题：

第一，Hermes Agent 如何安装？
第二，安装后需要配置什么？
第三，如何确认它真的可以正常工作？

2. 安装前需要理解的几个概念

在正式安装之前，先要理解 Hermes Agent 运行时涉及的几个基本对象。

2.1 Hermes Agent 本体

Hermes Agent 本体可以理解为 Agent 的运行框架。它负责管理对话、工具调用、记忆、skills、配置文件、模型 provider 和运行入口。

也就是说，Hermes Agent 本身不是大模型，而是一个把大模型组织成 Agent 的系统。

2.2 Model Provider

Hermes Agent 需要接入一个模型提供方，才能真正生成回答和执行推理。这个模型提供方可以是官方推荐的 Nous Portal，也可以是 OpenAI、OpenRouter 或其他兼容接口。

所以安装 Hermes Agent 之后，通常还需要进行模型配置。否则你虽然安装好了命令行程序，但它无法真正完成对话。

2.3 Tool Gateway

Agent 和普通聊天机器人的区别，很大程度上体现在工具调用上。Tool Gateway 可以理解为 Hermes Agent 管理工具调用能力的入口。通过它，Agent 才能执行文件读取、命令运行、搜索、浏览器调用等更复杂的操作。

如果只是测试普通聊天，可以暂时不深入理解 Tool Gateway；但如果后续要让 Hermes Agent 做项目分析、代码修改、自动化任务，就一定绕不开它。

2.4 配置文件

Hermes Agent 的运行依赖配置文件。配置文件会保存 provider、模型、工具启用情况、平台入口、gateway 等信息。

从学习角度看，配置文件非常重要，因为它体现了 Hermes Agent 如何从一个命令行程序变成一个可持续运行的 Agent 系统。

3. 安装环境选择

Hermes Agent 支持多种运行环境，例如 Linux、macOS、WSL2、Android Termux，也提供了 Windows 相关支持。不过从稳定性和学习成本来看，如果是 Windows 用户，我更建议优先使用 WSL2 中的 Ubuntu 环境。

原因很简单：Agent 项目通常会涉及 shell 命令、文件路径、Python 环境、系统依赖和后台进程。如果直接在 Windows 原生环境中运行，路径、权限和依赖问题可能会更复杂。而 WSL2 提供了更接近 Linux 的环境，更适合学习这类开源 Agent 项目。

因此，本文的默认环境是：

Ubuntu / WSL2 / Linux / macOS

如果你是 Windows 用户，可以先安装 WSL2 和 Ubuntu，然后在 Ubuntu 终端中执行后续命令。

4. 使用一行命令安装 Hermes Agent

官方推荐的快速安装方式是一行命令：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

这条命令的作用可以拆成两部分来看。

前半部分：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh

表示从 Hermes Agent 的 GitHub 仓库中下载安装脚本。

后半部分：

| bash

表示把下载到的脚本交给 bash 执行。

也就是说，这不是简单安装一个 Python 包，而是执行官方提供的安装脚本，让它自动完成环境检查、依赖安装、目录创建和命令链接等工作。

安装完成后，可以先检查命令是否可用：

hermes --help

如果能够看到 Hermes Agent 的命令帮助信息，说明基础安装已经成功。

也可以查看版本信息：

hermes --version

如果终端提示找不到 hermes 命令，通常有几种可能：

第一，安装没有成功。
第二，命令所在目录没有加入 PATH。
第三，当前终端还没有刷新环境变量。
第四，使用的是 Windows CMD 或 PowerShell，而不是 WSL2/Linux 终端。

这时可以先重新打开终端，或者检查 ~/.local/bin 是否已经加入 PATH。

5. 第一次配置：hermes setup

安装完成后，下一步是配置 Hermes Agent。最直接的方式是运行：

hermes setup

这个命令会进入配置向导，帮助用户逐步选择模型 provider、模型、工具和其他运行选项。

如果使用官方推荐的 Nous Portal，可以使用：

hermes setup --portal

这个命令更偏向“一键式初始化”。它会帮助用户登录 Nous Portal，设置 Nous 作为 provider，并启用相关工具网关配置。

从学习角度看，我建议第一次运行时不要急着跳过配置过程，而是认真观察 setup 向导问了哪些问题。因为这些问题基本对应 Hermes Agent 的核心组成部分：

• 你要使用哪个模型 provider；

• 你要选择哪个模型；

• 是否启用工具；

• 是否启用 gateway；

• 是否配置不同平台入口；

• 是否保存为默认配置。

这些配置项背后反映的是 Agent 系统的基本架构。模型负责推理，工具负责执行，gateway 负责连接外部平台，配置文件负责保存整个系统的运行状态。

6. 选择模型 provider

Hermes Agent 不是一个封闭模型，所以它需要选择模型 provider。

第一次学习时，可以优先选择官方推荐路径，这样排错成本最低。等后续熟悉之后，再尝试 OpenAI、OpenRouter 或其他兼容接口。

这里要注意一点：Agent 的使用体验不仅取决于模型本身，也取决于模型是否擅长工具调用、长上下文理解、指令遵循和多步任务规划。

有些模型单轮问答能力不错，但不一定适合作为 Agent 的底层模型。因为 Agent 场景要求模型不仅会回答，还要会判断什么时候调用工具、如何拆解任务、如何处理执行结果、如何在多轮任务中保持目标一致。

所以选择 provider 和模型时，不能只看模型榜单，还要结合 Agent 使用场景。

7. 第一次启动 Hermes Agent

完成安装和配置后，可以直接运行：

hermes

这会进入 Hermes Agent 的交互式终端界面。

第一次启动后，可以先不要给它复杂任务，而是用一些简单问题测试基本对话能力。例如：

你好，请用一句话介绍你现在的运行状态。

然后再测试它是否知道自己可以做什么：

你当前可以使用哪些工具？请简单列出来。

如果配置正常，Hermes Agent 应该能够正常回复，并说明当前可用能力。

接着，可以尝试一个稍微更接近实际使用的任务：

请帮我总结当前目录下 README 文件的主要内容。

如果当前目录中存在 README 文件，并且 Hermes Agent 的文件工具可用，它就可能尝试读取文件并给出摘要。

这个测试很重要，因为它可以初步验证 Hermes Agent 是否已经从“普通聊天”进入了“工具辅助工作”的状态。

8. 常用命令初步整理

完成第一次运行后，可以先记住几个基础命令。

8.1 启动对话

hermes

这是最基本的命令，用于启动 Hermes Agent 交互界面。

8.2 重新配置模型

hermes model

这个命令用于选择或切换模型 provider 和模型。

当你想从 Nous Portal 切换到其他 provider，或者更换不同模型时，可以使用这个命令。

8.3 配置工具

hermes tools

这个命令用于管理 Hermes Agent 的工具能力。

Agent 的能力边界很大程度上取决于工具是否启用。比如文件读取、shell、搜索、浏览器等能力，通常都需要在工具层进行管理。

8.4 重新运行配置向导

hermes setup

当你想重新初始化配置，或者第一次配置没有成功时，可以再次运行这个命令。

8.5 检查环境问题

hermes doctor

这是排错时非常有用的命令。它可以帮助检查安装、配置、依赖和运行环境是否存在问题。

如果遇到 Hermes 不能启动、模型不能调用、工具不能运行等情况，可以优先执行这个命令。

8.6 更新 Hermes Agent

hermes update

开源 Agent 项目更新频率通常比较高，所以后续学习时可能需要及时更新到新版本。

不过，如果你正在写博客或复现实验，建议记录当前版本，避免因为版本变化导致命令、配置或界面不一致。

8.7 启动 messaging gateway

hermes gateway

这个命令用于启动消息网关。后续如果要把 Hermes Agent 接入 Telegram、Discord、Slack 等平台，就会用到它。

第二期暂时不展开 gateway，后面可以单独写一篇。

8.8 继续上一次会话

hermes --continue

这个命令用于恢复上一次会话。对于长期 Agent 来说，会话连续性非常重要，因此这个命令也值得后续重点关注。

9. 第一次运行时建议测试什么？

第一次运行 Hermes Agent，不建议一上来就让它做复杂任务。更合理的方式是逐步测试它的能力边界。

9.1 测试普通对话

先确认模型是否能够正常回复：

请简单介绍一下 Hermes Agent 的核心能力。

如果这个阶段都无法回复，说明 provider 或模型配置可能存在问题。

9.2 测试文件读取

在当前目录放一个简单的 README.md 文件，然后输入：

请读取当前目录下的 README.md，并总结其中的主要内容。

如果 Hermes Agent 能够读取并总结文件，说明文件工具基本可用。

9.3 测试项目理解

进入一个小型代码项目目录，然后输入：

请先不要修改代码，只阅读这个项目的目录结构，并告诉我它大概是什么类型的项目。

这个测试可以观察 Hermes Agent 是否会主动分析目录、读取关键文件，并形成项目级理解。

9.4 测试命令执行

可以尝试一个安全命令：

请查看当前目录下有哪些文件。

如果它调用类似 ls 的命令，就说明 shell 工具可以正常工作。

不过，不建议第一次就让它执行删除、安装、覆盖、批量修改等高风险操作。Agent 工具调用能力越强，越要注意安全边界。

10. 安装与运行中可能遇到的问题

10.1 hermes 命令找不到

如果安装后执行：

hermes

出现：

command not found: hermes

可以检查是否是 PATH 问题。常见做法是重新打开终端，或者执行：

echo $PATH

看看 ~/.local/bin 是否在 PATH 中。

如果不在，可以临时添加：

export PATH="$HOME/.local/bin:$PATH"

如果确认有效，再把这行加入 ~/.bashrc 或 ~/.zshrc。

10.2 provider 配置失败

如果模型 provider 配置失败，需要检查：

• API key 是否正确；

• 网络是否可以访问对应服务；

• provider 名称是否选择正确；

• 当前模型是否支持所需能力；

• 是否需要重新运行 hermes setup。

这类问题通常不是 Hermes Agent 本体错误，而是模型服务、账号、网络或配置项的问题。

10.3 工具无法调用

如果普通聊天正常，但文件读取或命令执行失败，可能是工具没有启用，也可能是权限问题。

可以尝试：

hermes tools

检查相关工具是否启用。

也可以执行：

hermes doctor

让 Hermes Agent 检查当前环境。

10.4 Windows 环境问题

如果在 Windows 原生命令行中遇到问题，可以优先切换到 WSL2 Ubuntu 环境。对于学习 Agent 项目来说，Linux 环境通常更稳定，也更接近官方文档和开源社区的常见使用方式。

11. 第一次运行后的理解

完成安装和第一次运行后，我对 Hermes Agent 的理解会更具体一些。

第一，它不是一个单独的模型，而是一个 Agent 运行系统。
模型只是其中一层，除此之外还有工具、配置、记忆、skills、gateway 等模块。

第二，它的使用入口虽然是一个 hermes 命令，但背后对应的是完整的 Agent 工作流。
从 setup 到 provider，从 tools 到 gateway，每一步都在为长期运行做准备。

第三，第一次上手不要急着做复杂自动化。
更好的学习路线是先确认普通对话，再确认文件工具，再确认项目理解，再确认 shell 工具，最后再进入定时任务、MCP 和多平台接入。

第四，Agent 的安全边界需要从一开始就重视。
当它具备文件修改、命令执行、网络访问能力后，使用者就不能只关注“它能不能做”，还要关注“它是否应该做”和“它怎样安全地做”。

12. 小结

这一期主要完成了 Hermes Agent 的安装、配置和第一次运行。

从流程上看，基本步骤是：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup
hermes

如果使用官方推荐的 Portal 路线，也可以运行：

hermes setup --portal

安装完成后，可以通过 hermes 启动对话，通过 hermes model 管理模型，通过 hermes tools 管理工具，通过 hermes doctor 检查环境问题。

这一期的重点不只是“把它装上”，而是理解 Hermes Agent 的安装过程实际上对应了一个 Agent 系统的初始化过程：选择模型、启用工具、保存配置、建立运行入口，并为后续记忆、skills、gateway 和自动化任务打基础。

下一期，我将继续学习 Hermes Agent 的 CLI 使用方式，重点关注交互式终端界面、常用命令、slash command、多轮会话、文件读取和工具调用过程。