Hermes Agent 是 Nous Research 开源的 AI Agent 框架，采用单 Agent 架构加学习循环设计。它最大的特点是会自动提炼可复用的 Skill，记忆不会随会话结束而丢失。本文将带你从零开始，在全平台上完成安装和配置。

Hermes Agent 安装完全指南

一、什么是 Hermes Agent

Hermes Agent 是一个功能强大的 AI Agent 框架，能够自主执行开发协作、服务器运维、程序调试、项目搭建等复杂任务。它具备以下核心特性：

  • 自动提炼 Skill：每次完成任务后，会自动将经验转化为可复用的 Skill，持续进化
  • 持久化记忆：记忆不会随会话结束而丢失，跨会话保持上下文
  • 多平台支持：支持 Linux、macOS、Windows（含 WSL2）、Android Termux
  • 丰富工具链：内置搜索、浏览器、终端、文件操作、定时任务等 70+ 技能
  • 隐私优先：不收集遥测数据，所有数据存储在本地的 ~/.hermes/ 目录下

二、系统要求

Hermes 本身只是调用大模型 API 的客户端，不吃 GPU，能跑 Python 就行。具体前置依赖如下：

  • 必需：Git
  • 自动处理：Python、ripgrep、ffmpeg 等其余依赖由安装脚本自动处理

三、详细安装步骤

3.1 Linux / macOS / WSL2 安装

这是最常用的安装方式，一行命令即可完成。推荐使用国内镜像源，速度更快：

终端中运行安装命令（官方源和国内镜像源均可使用，国内用户推荐镜像源）。

终端安装命令示意图

3.2 Windows 原生安装

打开 PowerShell 并运行安装命令。安装程序会自动处理一切：uv、Python 3.11、Node.js 22、ripgrep、ffmpeg，以及便携式 Git Bash。

安装完成后请重启终端（或打开新的 PowerShell 窗口）以使 PATH 生效。

3.3 Android / Termux 安装

Hermes 提供 Termux 感知的安装路径，安装程序会自动检测 Termux 并切换到经过测试的 Android 流程。

四、安装后配置

4.1 模型配置

安装完成后，运行配置向导选择你要使用的大模型。支持的模型提供商包括：

  • 本地模型：支持 Ollama、vLLM、llama.cpp、LM Studio 等所有 OpenAI 兼容 API
  • 云端模型：主流大模型提供商均可接入
AI 模型配置向导界面

4.2 SOUL.md 灵魂配置

SOUL.md 是 Hermes 的灵魂文件，定义了 AI 的角色、性格和工作方式。

  • 文件位置：~/.hermes/SOUL.md
  • 编辑方式：使用任意文本编辑器修改

通过自定义 SOUL.md，你可以设定 AI 的回复风格、行为准则、专业方向，让它成为真正属于你的智能助手。

SOUL.md 配置文件示意图

4.3 网关配置（聊天平台接入）

Hermes 支持接入多种聊天平台，让你在常用的 App 里就能和 AI 对话。支持的平台包括：

  • 飞书、Telegram、Discord、Slack
  • 钉钉、企业微信、WhatsApp、Signal
  • Email、Home Assistant

推荐新手用飞书，配置最简单：跟着向导输入飞书的 AppID 和 AppSecret 即可。

五、常用命令速查

掌握以下常用命令，可以高效管理你的 Hermes Agent：

  • hermes：进入聊天模式，与 AI 对话
  • hermes config：查看和修改配置
  • hermes gateway setup：配置聊天平台网关
  • hermes tools：管理可用工具
  • hermes skills：查看和管理 Skill

六、常见问题与故障排查

Q1: hermes: command not found

解决方案：重新加载 shell 配置（source ~/.bashrc 或 ~/.zshrc），或者开一个新的终端窗口。

Q2: API key not set / 模型调用失败

解决方案：重新运行模型配置向导，检查 API Key 是否正确，以及网络是否能访问模型提供商。

Q3: 聊久了模型开始胡说八道

解决方案：在对话中输入 /compress，Hermes 会自动总结并压缩历史对话，节省 token 同时保持上下文连贯。

Q4: 更新后配置丢失

解决方案：运行配置检查和迁移命令，恢复默认配置或手动恢复。

Q5: 国内网络安装慢 / 失败

解决方案：使用国内镜像源，安装速度和稳定性会有显著提升。

七、装完先做三件事

  1. 定义性格：编辑 ~/.hermes/SOUL.md，设定 AI 的回复风格和角色定位
  2. 确认工作正常：在终端输入 hermes 进入聊天，试几轮对话
  3. 接一个聊天平台：用 hermes gateway setup 配置飞书或 Telegram，日常使用更方便

八、数据安全

Hermes 官方明确表示不收集遥测数据。所有对话、记忆、Skills 都存储在本地的 ~/.hermes/ 目录下。无论装在本地电脑还是云主机上，数据都在你手里。

项目地址：https://github.com/nousresearch/hermes-agent

官方文档：https://hermes-agent.nousresearch.com/docs