Hermes Agent从零到一的完整安装与使用教程

Hermes Agent从零到一的完整安装与使用教程

Hermes Agent是由Nous Research开发的开源自主AI智能体框架，主打“自我进化”——它能从任务中自动提炼技能、跨会话持久记忆，并支持接入Telegram、Discord等平台，实现越用越懂你。本教程将带你完成从环境准备到上手使用的全过程。

一、部署前准备

1.1 系统要求

Hermes Agent支持以下操作系统，且安装脚本会自动处理绝大部分依赖：

• Linux：主流发行版（Ubuntu、Debian、CentOS等），完全支持
• macOS：Intel及Apple Silicon芯片，完全支持
• Windows：原生不支持，需通过WSL2运行（官方推荐方案）
• Android：支持Termux环境

1.2 硬件建议

💡提示：多数用户选择接入外部大模型API，成本更低且对硬件要求不高。

1.3 前置依赖

唯一需要手动安装的前置依赖是Git。其他所有依赖（Python 3.11、Node.js v22、ripgrep、ffmpeg等）都将由安装脚本自动处理。

安装Git（Ubuntu/Debian示例）：

sudoaptupdate&&sudoaptinstallgit-y

二、安装方式详解

Hermes Agent提供三种主流安装方式，推荐新手使用一键安装，高级用户可选手动安装或容器化部署。

方式一：一键安装（推荐）

这是最快捷的安装方式，只需一行命令：

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

脚本会自动完成以下工作：

• 检测并安装缺失的依赖（Python 3.11、Node.js v22、ripgrep、ffmpeg等）
• 克隆Hermes Agent代码仓库
• 创建Python虚拟环境
• 将hermes命令添加到系统PATH

⚠️Windows用户特别注意：请先在PowerShell（管理员模式）中运行wsl --install安装WSL2并重启电脑，然后在Ubuntu终端中执行上述命令。

安装完成后，重新加载Shell并验证：

source~/.bashrc# 或 source ~/.zshrchermes--version# 应显示版本号如 v0.8.0

方式二：手动安装（适合高级用户）

如需完全掌控安装过程，可按以下步骤操作：

1. 克隆代码仓库（务必包含子模块）：

gitclone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcdhermes-agent

如果已克隆但未拉取子模块，执行：

gitsubmodule update--init--recursive

2. 安装uv包管理器并创建虚拟环境：

# 安装uv（如果尚未安装）curl-LsSfhttps://astral.sh/uv/install.sh|sh# 创建Python 3.11虚拟环境（uv会自动下载Python，无需sudo）uv venv venv--python3.11sourcevenv/bin/activate# Linux/macOS# 或 .\venv\Scripts\activate（Windows）# 安装Hermes及其所有功能uv pipinstall-e".[all]"

💡提示：虚拟环境路径已硬编码到入口脚本中，因此日常使用时无需手动激活虚拟环境，直接运行hermes命令即可。

方式三：容器化部署（Docker）

Hermes Agent提供官方Docker镜像，适合生产环境部署：

# docker-compose.yml 示例version:"3.8"services:hermes:image:nousresearch/hermes-agent:latestcontainer_name:hermesrestart:unless-stoppedcommand:gateway runvolumes:-/your/data/path:/opt/data# 替换为实际数据存储路径

启动容器后，进入容器内运行配置向导：

dockercompose up-ddockercomposeexec-ithermes-agent /bin/bash hermes setup# 在容器内运行配置向导

首次拉取镜像约需几分钟（镜像约2.4GB压缩，包含Playwright和Chromium浏览器自动化工具），后续重启将快速启动。

三、初始配置

安装完成后，运行以下命令启动交互式配置向导：

hermes setup

向导会依次引导你完成以下配置：

3.1 选择大语言模型（LLM）

Hermes Agent支持超过200种模型，主要通过以下方式接入：

• OpenRouter：聚合平台，一键切换多种模型，对国内用户友好
• OpenAI：直接使用GPT系列模型
• Anthropic：使用Claude系列模型
• Nous Portal：官方推理门户，支持400+模型
• Ollama：接入本地部署的开源模型
• 自定义OpenAI兼容端点：可接入国内模型服务（如通义千问、Kimi、智谱GLM等）

按提示输入对应的API密钥即可。

3.2 配置内置工具

Hermes Agent内置超过40种工具，包括：

• 文件系统操作（读写、搜索）
• Shell命令执行
• 网络请求与网页抓取
• 浏览器自动化（Playwright）
• 定时任务调度
• 代码执行与调试

运行以下命令可随时管理工具：

hermes tools# 启用/禁用各类工具

3.3 配置消息网关（可选）

如需将Agent接入聊天平台，运行：

hermes gateway setup

支持接入的平台包括：

• Telegram
• Discord
• Slack
• Signal
• 飞书、钉钉等（通过社区适配）

3.4 单项配置管理

你也可以单独修改某个配置项：

hermes model# 选择或切换模型hermes configset<key><value># 修改单个配置值hermes config list# 查看当前全部配置

所有配置存储在~/.hermes/目录下的.env和config.yaml文件中。

四、快速上手

4.1 启动对话

配置完成后，直接运行以下命令进入交互式命令行界面：

hermes

现在你可以像与人聊天一样向Hermes Agent下达指令了。

4.2 常用命令速查

在对话中，你可以使用以下内置命令：

4.3 实用示例

# 示例1：让Agent分析项目代码并给出优化建议>请分析当前目录下的Python代码，找出潜在的性能问题并给出改进方案# 示例2：定时任务（使用自然语言）hermes schedule"每天早上8点，汇总我的未读邮件并发送到Telegram"# 示例3：自动创建技能>帮我写一个脚本，每天自动备份指定文件夹到云存储，并生成备份日志

执行后，Agent会自动将成功经验提炼为可复用的“技能”文件，存储在~/.hermes/skills/目录中，下次遇到类似任务可直接调用。

五、常见问题排查

Q1：安装时提示“git: command not found”

# Ubuntu/Debiansudoaptinstallgit-y# macOSxcode-select--install# CentOS/RHELsudoyuminstallgit-y

Q2：WSL2中安装后无法启动

确保WSL2版本正确（wsl --version应显示版本2）。若为WSL1，执行：

wsl --set-version<发行版名>2

Q3：API调用失败或超时

• 检查API密钥是否有效且有余额
• 若在国内网络环境，建议使用国内模型服务端点或配置代理
• 尝试运行hermes model重新配置模型

Q4：内存不足导致进程被终止

浏览器自动化（Playwright）功能需要至少2GB可用内存。建议：

• 升级服务器配置至2核4GB以上
• 或在hermes tools中禁用浏览器相关工具

Q5：如何完全卸载？

rm-rf~/.hermes# 删除所有配置、记忆和技能数据# 同时删除PATH中的hermes命令（通常位于 ~/.local/bin/hermes）

六、进阶资源

• 官方文档：https://hermes-agent.nousresearch.com/docs
• GitHub仓库：https://github.com/NousResearch/hermes-agent
• 环境变量完整参考：Environment Variables Reference
• 消息网关配置指南：Messaging Gateway Guide
• Nix/NixOS专用配置：Nix Setup Guide
• Termux（Android）专用指南：Termux Guide

📘推荐阅读：社区贡献的《Hermes橙皮书》系统地介绍了三层记忆系统、Skill自进化机制等高级特性，适合深入学习。