十七、Hermes-Agent 使用指南

1. 一键安装脚本（推荐）

最快 2 分钟完成安装，适合大多数用户。安装脚本自动处理所有依赖：

ShellCopyxxxxxxxxxx8 1# Windows (WSL2)/macOS / Linux一行命令完整安装2curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash34# 安装完成后加载环境变量并启动5source ~/.bas

安装脚本自动完成：Python 依赖安装、路径配置、初始化向导触发。

验证安装

ShellCopyxxxxxxxxxx2 1# 预期输出：hermes v0.8.0 (v2026.4.8)2hermes --version

手动安装（网络受限环境）

ShellCopyxxxxxxxxxx6 1# 克隆仓库2git clone https://github.com/NousResearch/hermes-agent.git3cd hermes-agent45pip install -r requirements.txt6python -m hermes

2. 配置 Hermes Agent的模型

依赖环境安装完成后，系统会自动进入 Hermes Agent 的终端配置向导。强烈建议新手直接通过键盘上下键选择第一项 Quick setup（快速设置）。

方法一：使用交互式配置向导（推荐）

这是最简单、最推荐新手的方法。

1在终端中输入并运行配置向导：

hermes setup 会依次引导完成 LLM 提供商选择、工具启用和网关配置。

2推荐：使用自定义端点（custom endpoint）：输入服务器地址：https://ai.yunsuguan.com

3输入 API Key：根据你选择的提供商，粘贴你的 API Key 并按回车。输入时屏幕不会显示字符，这是正常的安全保护措施。a获取 API Key：可以在API平台创建并获取。

4输入模型名称：获取你选择的提供商下的可用模型列表，选择一个作为默认模型即可。 配置完成后，就可以开始使用了。你也可以随时用 hermes model 命令来快速切换模型。

方法二：手动编辑配置文件

如果需要更精细的控制，也可以直接编辑配置文件。

主配置文件：~/.hermes/config.yaml，用于配置模型、提供商等核心设置。

环境变量文件：~/.hermes/.env，用于安全地存放所有 API Key。

快速编辑：可以使用以下命令直接打开配置文件进行修改：

3. 基本使用与常用命令

配置完成后，就可以和 Hermes Agent 对话了。

开始对话：在终端输入 hermes 并回车，即可进入交互式聊天界面，开始你的第一条消息。

后台运行：让 Agent 在后台持续运行：

运行健康检查：检查所有依赖和配置是否正确：

常用命令速查表

常见问题与解决思路

1安装失败或 hermes 命令找不到：请先确认网络连接正常，能够访问 GitHub。安装完成后，记得执行 source ~/.bashrc 或重启终端。

2模型调用失败 (401 Unauthorized)：这通常是 API Key 无效或未正确配置。请使用 hermes setup 重新配置你的 API Key