Hermes Agent入门

Hermes Agent介绍

Hermes Agent 是由 Nous Research (也是 Hermes 系列大模型背后的实验室)推出的具备自我进化能力的通用AI Agent框架,它不仅能自主使用工具、编写并执行代码,还能在任务完成后自动总结经验,将工作流沉淀为可复用的“技能”,并在后续使用中持续优化这些技能。配合跨会话的持久化记忆与用户画像建模,Hermes 能够随着使用时间的增长变得越来越懂用户,真正实现了从“被动执行”到“主动进化”的跨越。

Hermes Agent 特点如下:

  • 可灵活配置多种模型厂商,支持200+主流模型(从 OpenAI 到国产 Kimi、MiMo 等)

  • 本地 / Docker / SSH / 云函数 / GPU 集群均可运行

  • 可以通过CLI访问,通过统一的网关设计,也可以 Telegram、Discord、微信等多平台访问。

  • 自我进化能力,Skill可以自动生成、自我优化并写入长期记忆,后续可直接使用

  • 空闲时成本接近为零,适合长期运行

Hermes Agent文档地址:https://hermes-agent.nousresearch.com/docs

Hermes Agent安装

Hermes Agent 的本质是一个基于 Python 和 Node.js 运行的智能体框架。可以安装在Linux/macOS/Windows(需要安装在WSL2环境)中,这里以 Unbuntu 系统为例来安装Hermes Agent 。

  • 安装Hermes Agent前需要有如下环境:
  • Python (>=3.11): Agent 逻辑运行的基础环境。
  • Node.js (>=22): 主要用于支撑浏览器自动化(Playwright)和 WhatsApp 桥接等高级功能。
  • Git: 用于版本控制和一键安装脚本的拉取。
  • 系统工具:ripgrep / ffmpeg(非硬性依赖,缺失时会提示手动安装)

注意:对于绝大多数用户,不需要提前手动安装上述任何依赖。Hermes 的一键安装脚本内置了强大的环境检测能力,会自动检测并为你补足缺失的部分,唯一建议提前确认的底层工具是 Git,因为脚本在拉取代码时首选 git clone。

执行如下命令在Ubuntu系统中安装Hermes Agent:

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

注意:安装过程中如果遇到一些链接不能访问可以打开或者关闭魔法多次尝试。

等待一定时间后,进入如下页面说明Hermes Agent 已经安装成功。

image-20260609085829525

Hermes Agent 配置

  1. 进入配置向导

    image-20260609120533969

  2. 现在配置消息渠道,选择skip跳过这一步

    image-20260609120628957

  3. 选择模型供应商

    image-20260609121645170

    选择DeepSeek,国内可以直接使用

    image-20260609121734539

    配置对应得分key

    image-20260609121858396

    image-20260609122011307

    image-20260609122042280

  4. 配置完成

    image-20260609120834085

Hermes Agent 简单使用

  • 对话

    hermes
    

    image-20260609121350447

    image-20260609122154594

  • 多行输入

    如果要多行输入,可以按 Alt+Enter或者 Ctrl+J 换行。

    image-20260609131853968

  • 中断Agent

    与Hermes Agent进行对话过程中,可以按“Ctrl+C”中断Agent运行并切换到新的指令。2秒内再次按下“Ctrl+C”会退出 Hermes Agent。

  • /model

    在对话中输入“/model”可以列出已有模型并切换:

    image-20260609131316122

  • /tools

    在对话中输入“/tools”可以列出所有可用命令:

    image-20260609131141819

Hermes Agent 命令

以下命令可以在安装Hermes Agent完成后执行。

#开始进入聊天 
hermes 

#选择大语言模型提供商和模型 
hermes model 

#配置启动哪些工具 
hermes tools 

#完整设置向导(一次性完成全部配置) 
hermes setup 

#查看当前配置 
hermes config 

#重启hermes gateway服务(如果安装后,通过此命令启动) 
hermes gateway restart 

#配置连接消息平台 
hermes gateway setup 

#恢复上次对话 
hermes --continue 

#诊断问题 
hermes doctor

#更新至最新版本
hermes update

更多命令可以通过“hermes –help”查看。

Hermes Agent 配置目录结构

安装完成Hermes Agent后,所有设置均存储在~/.hermes/目录中,以便访问。该目录下的结构如下:

~/.hermes/
├── config.yaml     # 配置项(模型、终端、TTS、压缩等)
├── .env            # API 密钥与敏感信息
├── auth.json       # OAuth 提供商凭证(Nous Portal 等)
├── SOUL.md         # 主 Agent 身份(系统提示中的第 1 槽位)
├── memories/       # 持久记忆(MEMORY.md、USER.md)
├── skills/         # Agent 创建的技能(由 skill_manage 工具管理)
├── cron/           # 定时任务
├── sessions/       # 网关会话
└── logs/           # 日志(errors.log、gateway.log——自动脱敏)

配置优先级按照如下顺序进行解析(优先级从高到低):

  1. CLI 参数 —— 例如 hermes chat –model anthropic/claude-sonnet-4(每次调用的覆盖)
  2. ~/.hermes/config.yaml —— 用于所有非敏感设置的主要配置文件
  3. ~/.hermes/.env —— 环境变量的备用位置;必须用于敏感信息(API 密钥、令牌、密码)
  4. 内置默认值 —— 当其他设置均未配置时使用的硬编码安全默认值
--- 本文结束 The End ---