本文参考：
Hermes Agent 官方文档
Hermes Agent GitHub 仓库

Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架，运行在终端、消息平台和 IDE 中。它属于 Claude Code（Anthropic）、Codex（OpenAI）同类的自主编码和任务执行代理，通过工具调用与系统交互。Hermes 支持任意 LLM 提供商（OpenRouter、Anthropic、OpenAI、DeepSeek、本地模型等 15+ 种），可在 Linux、macOS 和 WSL 上运行。

与其他 AI Agent 相比，Hermes Agent 有几个显著特点：

  • 通过技能自我改进：Hermes 通过将可复用的过程保存为技能（Skills）来学习经验。当它解决复杂问题、发现工作流或被纠正时，可以将这些知识持久化为技能文档，在未来的会话中加载。技能随时间积累，使代理在特定任务和环境中表现越来越好。
  • 跨会话持久记忆：记住你是谁、你的偏好、环境细节和经验教训。可插拔的内存后端（内置、Honcho、Mem0 等）让你选择内存的工作方式。
  • 多平台网关：同一个代理可以运行在 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Email 等 10+ 个平台上，并拥有完整的工具访问权限。
  • 提供商无关：可以在工作流中随时切换模型和提供商，凭证池自动跨多个 API 密钥轮换。
  • 可扩展：支持插件、MCP 服务器、自定义工具、Webhook 触发、定时任务和完整的 Python 生态。

人们使用 Hermes 进行软件开发、研究、系统管理、数据分析、内容创作、家庭自动化等任何需要持久上下文和完整系统访问的 AI 代理场景。

安装

Hermes Agent 的安装非常简单，执行以下命令即可：

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

安装完成后，可以通过以下命令检查是否安装成功：

1
hermes --version

初始配置

安装完成后，运行安装向导进行初始配置：

1
hermes setup

该向导会引导你配置模型、终端、网关、工具和代理设置。

配置模型提供商

Hermes 支持 20+ 种模型提供商。使用以下命令交互式选择模型和提供商：

1
hermes model

常用的提供商包括：

提供商 环境变量
OpenRouter OPENROUTER_API_KEY
Anthropic ANTHROPIC_API_KEY
OpenAI OPENAI_API_KEY
Google Gemini GOOGLE_API_KEY
DeepSeek DEEPSEEK_API_KEY
Xiaomi MiMo XIAOMI_API_KEY

你需要在 ~/.hermes/.env 文件中设置对应的 API 密钥。

检查健康状态

使用以下命令检查配置和依赖是否正确：

1
hermes doctor

如果有问题，可以尝试自动修复：

1
hermes doctor --fix

基本使用

交互式聊天

直接运行 hermes 命令即可进入交互式聊天模式：

1
hermes

进入后，你可以像和普通 AI 对话一样与 Hermes 交流，但不同的是，Hermes 可以执行命令、读写文件、搜索网络等操作。

单次查询

如果你只需要问一个问题，不需要进入交互模式：

1
hermes chat -q "什么是 LAMP 环境？"

指定模型

可以在运行时指定使用的模型：

1
hermes chat -m anthropic/claude-sonnet-4 -q "解释一下 Docker 的基本概念"

技能系统

技能（Skills）是 Hermes Agent 的核心特性之一。技能是可复用的程序文档，Hermes 通过学习经验自动创建和更新。

查看已安装技能

1
hermes skills list

搜索技能

1
hermes skills search "docker"

安装技能

1
hermes skills install <skill-id>

工具系统

Hermes 通过工具集（Toolsets）来管理可用的工具。使用以下命令查看和管理工具：

1
hermes tools list

常用的工具集包括：

  • terminal：Shell 命令和进程管理
  • file：文件读写搜索
  • web：网络搜索和内容提取
  • browser：浏览器自动化
  • vision：图像分析
  • memory：跨会话持久记忆

启用或禁用工具：

1
2
hermes tools enable browser
hermes tools disable vision

工具更改需要在新会话中生效，使用 /reset 命令重置会话。

会话管理

Hermes 会自动保存会话记录，你可以随时恢复之前的会话。

列出最近会话

1
hermes sessions list

恢复会话

1
hermes --continue

或者恢复指定会话：

1
hermes --resume <session-id>

定时任务

Hermes 支持创建定时任务，类似 cron 的功能：

1
hermes cron create "0 9 * * *" -q "查看今天的天气"

查看定时任务：

1
hermes cron list

网关（消息平台）

Hermes 可以通过网关连接到各种消息平台，让你在 Telegram、Discord 等平台直接与 Hermes 对话。

配置网关

1
hermes gateway setup

启动网关

1
2
hermes gateway install
hermes gateway start

查看状态

1
hermes gateway status

会话内命令

在交互式聊天会话中，你可以使用斜杠命令：

  • /help：显示帮助
  • /new：新建会话
  • /model：查看或切换模型
  • /skills：搜索安装技能
  • /tools：管理工具
  • /config：查看配置
  • /quit：退出

配置文件

Hermes 的配置文件位于：

  • 主配置：~/.hermes/config.yaml
  • 环境变量：~/.hermes/.env

你可以直接编辑这些文件，或者使用命令：

1
2
hermes config edit
hermes config set <key> <value>

总结

Hermes Agent 是一个功能强大的 AI Agent 框架，它不仅能够进行对话，还能执行命令、管理文件、搜索网络，甚至连接到各种消息平台。通过技能系统，Hermes 可以不断学习和改进，成为你真正的 AI 助手。

本文只是介绍了 Hermes Agent 的基本安装和使用方法，更多高级功能如 MCP 服务器、Webhook、Profile 等，可以参考官方文档进行深入学习。