当前位置：

文章详情

🚀Hermes Agent是什么、怎么部署？2026年保姆级超详细实操教程

Hermes Agent是由Nous Research开源的可自进化、带持久记忆、支持多工具与多平台接入的自主AI智能体，核心是能自主规划任务、沉淀技能、跨会话记忆，并通过终端、Docker、远程服务器等灵活部署，适配个人助手、开发协作、自动化运维等场景。它不是简单的聊天机器人，而是具备学习闭环的数字助手，越用越智能。以下从核心定义、部署准备、本地/容器/远程部署、配置与使用、避坑指南全流程详解。

image.png

一、Hermes Agent核心定义与核心能力

1. 核心定位

Hermes Agent是开源自主AI智能体框架，遵循MIT协议，主打自进化、持久记忆、多工具调用、多入口接入，支持本地/云端/容器化部署，兼容OpenAI、Anthropic、Nous等主流大模型API，可作为个人数字助理、开发协作工具、自动化运维助手使用。区别于传统AI助手，它内置学习循环，完成任务后会提取经验沉淀为“技能”，后续复用提升效率。

2. 核心能力

持久化记忆：通过MEMORY.md、USER.md跨会话保存偏好、项目信息、学习成果，重启不丢失。
技能系统：内置40+技能（MLOps、GitHub、文件编辑、网页搜索等），支持自动生成、社区共享技能。
多工具调用：支持终端执行、文件读写、浏览器自动化、定时任务，可并行处理复杂任务。
多入口接入：CLI、Telegram、Discord、微信等平台共用网关，一处部署多端使用。
灵活部署：支持本地终端、Docker、SSH远程、云服务器，适配从个人电脑到企业集群的全场景。
隐私安全：数据本地存储，零数据追踪，容器化部署支持安全加固。

二、部署前准备：环境与依赖检查

1. 系统支持

Linux：Ubuntu、Debian、CentOS等，完全支持（推荐）。
macOS：Intel/Apple Silicon，完全支持。
Windows：不支持原生，需安装WSL2（Windows Subsystem for Linux 2）。
Android：Termux环境可运行。

2. 硬件要求

最低配置：1核1GB内存（配合外部大模型API，仅运行Agent核心）。
推荐配置：4GB+内存，2核CPU，本地运行模型需更高配置（如16GB+显存）。

3. 前置依赖

仅需安装git，其余依赖（Python 3.11、Node.js、虚拟环境等）由安装脚本自动处理。

# 安装git（以Ubuntu为例） sudo apt update && sudo apt install git -y

4. 🚀Hermes Agent部署保姆级教程

本教程将引导大家基于阿里云计算巢来部署并配置Hermes Agent：
1、注册阿里云账号，访问计算巢 HermesAgent 社区版。

按页面提示填写部署参数：

image.png

2、参数配置完成后，系统将自动生成费用预估明细。确认无误后点击下一步：确认订单。

3、在订单确认页，核对实例信息与费用，点击立即创建开始自动部署。

4、部署完成后远程链接ECS。

image.png

5、执行命令与HermesAgent进行交互。

sudo su root hermesimage.png

三、本地部署：一键安装（推荐，新手首选）

1. 执行一键安装脚本

类Unix系统（Linux/macOS/WSL2）直接运行以下命令，脚本自动完成依赖安装、仓库克隆、虚拟环境配置、全局命令注册：

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

国内用户可使用加速镜像：

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

2. 刷新环境变量

安装完成后，重载Shell配置使hermes命令全局生效：

# Bash用户 source ~/.bashrc # Zsh用户 source ~/.zshrc

3. 验证安装

执行以下命令检查安装状态，确保无报错：

hermes version # 查看版本 hermes doctor # 环境诊断 hermes status # 配置状态

若提示command not found，检查~/.local/bin是否在PATH中，或重新执行安装脚本。

四、手动部署：自定义安装（适合开发者）

1. 克隆仓库（含子模块）

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 若未加--recurse-submodules，执行子模块更新 git submodule update --init --recursive

2. 安装uv并创建虚拟环境

uv是快速Python包管理器，自动安装Python 3.11：

curl -LsSf https://astral.sh/uv/install.sh | sh uv venv venv --python 3.11

3. 安装依赖

export VIRTUAL_ENV="$(pwd)/venv" uv pip install -e .

4. 配置全局命令

sudo ln -sf "$(pwd)/venv/bin/hermes" /usr/local/bin/hermes

5. 验证安装

同一键安装，执行hermes version、hermes doctor检查。

五、Docker部署：容器化运行（生产/隔离环境）

1. 安装Docker（以Ubuntu为例）

sudo apt update sudo apt install docker.io -y sudo systemctl start docker sudo systemctl enable docker

2. 拉取官方镜像

docker pull nousresearch/hermes-agent:latest

3. 运行容器（挂载本地配置）

docker run -it --rm -v ~/.hermes:/root/.hermes # 挂载本地配置目录 nousresearch/hermes-agent:latest

容器内直接执行hermes命令即可使用，配置与本地同步。

六、远程部署：VPS/云服务器部署（24小时运行）

1. 服务器准备

选择Linux云服务器（如Ubuntu 22.04），完成基础配置（更新系统、安装git）。

2. 执行安装脚本

同本地一键安装，在服务器终端运行：

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

3. 后台运行（保持进程不中断）

使用nohup或tmux后台运行：

# 方法1：nohup nohup hermes gateway & # 启动网关（多端接入） # 方法2：tmux（推荐，可重连） tmux new -s hermes hermes gateway # 退出tmux：Ctrl+b d；重连：tmux attach -t hermes

七、核心配置：对接大模型与个性化设置

1. 初始化配置

执行配置向导，自动生成.env与config.yaml：

hermes setup

2. 配置大模型API（关键步骤）

编辑~/.hermes/.env，填入模型API Key（至少填一个）：

# Nous Portal（推荐，适配Hermes模型） NOUS_API_KEY=你的密钥 # OpenAI OPENAI_API_KEY=你的密钥 # OpenRouter（访问200+模型） OPENROUTER_API_KEY=你的密钥 # Anthropic Claude ANTHROPIC_API_KEY=你的密钥

3. 模型选择与参数调整

hermes model # 选择默认模型、调整温度、最大token等

4. 个性化配置（可选）

编辑~/.hermes/config.yaml，设置人格、技能启用、工具权限。
编辑~/.hermes/USER.md，添加个人偏好、项目信息，提升Agent理解度。

八、启动与使用：基础操作演示

1. 启动CLI交互模式

hermes # 进入交互式TUI界面，支持多行输入、命令补全

2. 常用命令

hermes chat "帮我写一个Python脚本，实现文件批量重命名" # 直接对话 hermes skill list # 查看已安装技能 hermes skill install github # 安装GitHub技能 hermes memory show # 查看记忆内容 hermes gateway setup # 配置多端接入（微信、Telegram等）

3. 多端接入（以微信为例）

hermes gateway setup # 选择weixin（个人微信），扫码登录，自动保存配置 hermes gateway start # 启动网关，微信即可与Agent对话

九、避坑指南：常见问题与解决方案

Windows原生无法安装：必须安装WSL2，管理员PowerShell执行wsl --install，重启后在WSL2终端运行安装脚本。
hermes命令找不到：执行source ~/.bashrc或source ~/.zshrc，或手动添加export PATH="$HOME/.local/bin:$PATH"到Shell配置文件。
模型API调用失败：检查.env中API Key是否正确，网络是否可访问模型接口，尝试切换模型（如从OpenAI切换到OpenRouter）。
内存不足：本地运行大模型需升级内存，或使用外部API，关闭本地模型加载。
网关启动失败：检查端口是否被占用，关闭冲突进程，或修改config.yaml中的网关端口。
技能安装失败：更新Hermes到最新版本，执行hermes update，或手动克隆技能仓库。

十、总结与进阶

Hermes Agent凭借自进化、持久记忆、多工具、多部署的核心优势，成为开源AI智能体的优选方案。从本地一键部署到容器化、远程运行，适配个人与企业场景；对接主流大模型，快速实现自动化任务、开发协作、智能助手等需求。新手可通过一键安装快速上手，开发者可自定义配置与扩展技能，结合避坑指南可高效解决部署问题。