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 ProviderHermes Agent 需要接入一个模型提供方才能真正生成回答和执行推理。这个模型提供方可以是官方推荐的 Nous Portal也可以是 OpenAI、OpenRouter 或其他兼容接口。所以安装 Hermes Agent 之后通常还需要进行模型配置。否则你虽然安装好了命令行程序但它无法真正完成对话。2.3 Tool GatewayAgent 和普通聊天机器人的区别很大程度上体现在工具调用上。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. 选择模型 providerHermes 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 Agenthermes update开源 Agent 项目更新频率通常比较高所以后续学习时可能需要及时更新到新版本。不过如果你正在写博客或复现实验建议记录当前版本避免因为版本变化导致命令、配置或界面不一致。8.7 启动 messaging gatewayhermes 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、多轮会话、文件读取和工具调用过程。