Hermes Agent 安装与配置全流程（2026年6月最新版）

核心结论：推荐使用官方一键安装脚本（最快2分钟完成），适配Linux/macOS/WSL2/Android(Termux)；不支持原生Windows系统；开发者可选手动安装。安装后执行hermes setup配置模型与API，即可开始使用。

一、前置知识与环境准备

1.1 核心特性与部署前提

在开始部署前，建议先了解 Hermes Agent 的核心特性，这将帮助您更好地理解后续的配置逻辑与系统能力：

智能自我进化：基于 FTS5 全文检索技术实现跨会话持久记忆，能够自动学习用户行为并生成程序化技能，随着使用时长增加，系统会越来越贴合您的个人习惯与工作流程
全生态兼容：支持 Telegram、Discord、Slack、微信等主流消息平台作为交互入口，同时兼容 Kimi、Nous Portal、OpenAI、Anthropic 等国内外主流大模型提供商
极致轻量化：提供单行命令一键安装方案，最低仅需 2 核 2G 服务器配置即可稳定运行，推荐使用 4 核 8G 配置以获得更流畅的交互体验
完全开源：采用宽松的 MIT 开源许可证，允许无限制地修改、分发和二次开发，拥有活跃的全球开发者社区提供技术支持与生态贡献

1.2 硬件与系统要求

准备类别	核心要求
系统要求	Linux/macOS/WSL2
硬件最低要求	CPU：x86_64/ARM64；内存：256MB；存储：100MB；网络：稳定联网
必须前置依赖	Git（2.0+）

1.3 前置依赖安装

Hermes Agent的安装脚本会自动处理Python 3.11、Node.js v22等核心依赖，无需手动安装，仅需确保系统已安装git（用于拉取源码，部分部署方式需用到）：

1.3.1 Linux（Ubuntu/Debian）

复制代码

# 更新系统包 
sudo apt update && sudo apt upgrade -y 
# 安装git 
sudo apt install git -y 
# 验证git安装 
git --version

1.3.2 macOS

macOS通常自带git，若未安装，通过Homebrew安装：

复制代码

# 安装Homebrew（若未安装） 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 
# 安装git 
brew install git 
# 验证git安装 
git --version

1.3.3 WSL2（Windows）

应用商店安装 WSL2（推荐 Ubuntu 22.04）
打开 WSL2 终端，执行 Linux git 安装命令

1.4 国内网络加速（必做）

国内服务器/本地环境访问GitHub 、pip/npm镜像速度较慢，提前配置加速可避免安装失败，配置完成后可正常执行后续步骤：

1.4.1 Git镜像加速（全局配置）

复制代码

git config --global url."https://mirror.ghproxy.com/https://github.com".insteadOf "https://github.com"

1.4.2 pip镜像加速

复制代码

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/
pip config set install.trusted-host mirrors.aliyun.com

1.4.3 设置npm镜像

复制代码

npm config set registry https://mirrors.cloud.tencent.com/npm/ --global

二、全平台三种安装方式（推荐新手选择第一种）

Hermes Agent 一共有三种部署方法，大家可以根据自己的情况来选：

如果你是新手，直接用单行命令安装就行，复制粘贴一条命令就能搞定，最简单最快
如果你要部署到生产环境，建议用Docker 部署，环境隔离做得好，不会和其他服务冲突
如果你是开发者，想要自己改代码加功能，那就选择源码部署，自由度最高

2.1 Linux / macOS / WSL2（最稳定，新手优选）

国内镜像源（优先使用，速度最快）

复制代码

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

国际官方源（海外用户使用）

复制代码

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

安装后必执行（刷新环境变量）

复制代码

# bash 用户
source ~/.bashrc
# zsh 用户
source ~/.zshrc

永久生效：直接关闭当前终端，重新打开新终端即可

2.2 Docker部署（环境隔离，推荐生产环境）

Docker部署可实现环境隔离，避免与系统其他软件冲突，适合长期运行和生产环境，步骤如下

复制代码

# Linux（Ubuntu）安装Docker
sudo apt install docker.io -y

# 启动Docker服务
sudo systemctl start docker
sudo systemctl enable docker

# 验证Docker安装
docker --version

# 拉取官方最新镜像（v0.8.0）
docker pull nousresearch/hermes-agent:latest

# 验证镜像拉取成功
docker images | grep hermes-agent

# 创建本地配置目录（用于持久化配置）
mkdir -p ~/.hermes/docker-config

# 启动容器（后台运行，映射配置目录）
docker run -d \
  --name hermes-agent \
  -v ~/.hermes/docker-config:/root/.hermes \
  -p 8080:8080 \
  nousresearch/hermes-agent:latest
  
# 查看容器运行状态
docker ps | grep hermes-agent

2.3 源码手动安装（适合开发者）

复制代码

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 创建并激活虚拟环境
python3.11 -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows

# 安装依赖
pip install --upgrade pip
pip install -e ".[all]"

# 创建软链接（可选，方便全局调用）
mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

三、核心配置

重要提示：安装完成后必须完成基础配置，否则 Hermes Agent 将无法正常运行。基础配置主要包括模型参数设置和工具权限开启两部分，以下配置方法适用于所有部署方式，本文以单行命令安装为例进行演示。

3.1.交互式配置向导（推荐）

复制代码

hermes setup

按提示选择LLM服务、输入API密钥、配置记忆后端等。

3.2 模型配置（关键步骤）

Hermes Agent支持多种模型提供商，可根据自身需求选择，推荐国内用户使用Kimi（国内优选，处理长文能力强，免费额度充足），国外用户可选择Anthropic、OpenAI，也可使用Ollama部署本地模型（完全离线）。

3.2.1 配置Kimi（推荐1）

复制代码

# 设置模型为Kimi
hermes config set model Kimi/Moonshot China
# 配置Kimi API Key（自行注册获取）
hermes config set KIMI_API_KEY sk-your-key-here

3.2.2 配置Anthropic Claude（推荐2）

复制代码

# 设置模型提供商为Anthropic
hermes config set model.provider anthropic
# 配置Anthropic API Key（需自行注册获取）
hermes config set model.api_key sk-ant-xxxxx

3.2.3 本地推理配置（推荐3）

复制代码

# 安装Ollama（先安装Ollama客户端）
ollama pull nous-hermes2
hermes model --local ollama:nous-hermes2

3.2.4 开启工具权限

接下来会询问你想启用哪些工具。新手建议先启用基础工具：

复制代码

web          # 网络搜索和网页提取
terminal     # 执行命令
file         # 读写文件
browser      # 浏览器自动化（可选）

四、启动验证

4.1 启动Hermes Agent

复制代码

*# 前台启动（适合测试，关闭终端则停止）**
*hermes start
 
*# 后台启动（推荐，长期运行）**
*nohup hermes start &
*# 查看后台运行状态*

4.2 成功启动

复制代码

What can I do for you today?
> 你好，介绍一下你自己

五、常见问题与解决方法

5.1安装失败

切换国内镜像源或检查网络连接
权限不足：Linux/macOS不要加sudo，Windows用管理员PowerShell
依赖缺失：手动安装git、curl等基础工具（Linux：sudo apt install git curl）

5.2 命令未找到

执行source ~/.bashrc或source ~/.zshrc刷新环境变量
Windows：重启PowerShell或手动添加%LOCALAPPDATA%\hermes\bin到系统PATH

5.3 模型连接失败

核对API密钥是否正确，是否有足够额度
本地Ollama：确保服务已启动（ollama serve），模型已正确拉取

5.4 网络超时

根因：国内网络访问GitHub受限，未配置镜像加速。
解决方案：重新配置1.4节的网络加速，或更换国内镜像源，重新执行安装命令。

5.5 更新Hermes Agent

复制代码

hermes update  # 一键更新
# 或手动更新
cd ~/.hermes/hermes-agent
git pull
git submodule update --init --recursive
uv pip install -e .

六、快速上手指南

复制代码

启动聊天：hermes
查看帮助：在聊天界面输入/help
运行技能：输入/skill list查看所有技能，/skill run <skill-name>运行技能
保存会话：输入/save <session-name>保存当前会话
退出：输入/exit或按Ctrl+C

七、结语

最后想特别说明，Hermes Agent 最大的亮点就是它会 "越用越懂你"。坚持使用一段时间后，它会慢慢熟悉你的操作习惯和常用技能，给你带来越来越顺手的体验。

不过有个关键步骤别忘：装完一定要先跑 hermes setup 填好密钥，把基础配置搞定，不然可没法用哦！

特别给国内小伙伴划重点：Kimi 大模型绝对是最佳拍档！中文理解能力强，长文档、论文、整个代码库拖进去都能轻松拿捏。写代码、调工具、处理各种复杂任务样样在行，和 Hermes 强强联手，直接让你的工作效率原地起飞！