Hermes Agent它不是单纯的对话工具，也不是单一的代码助手，而是一套具备持久记忆、技能沉淀、自我迭代、多智能体协同的完整自主智能体框架。本系列带你从入门、核心能力、自主进化、多机协作多维度，一次性讲透 Hermes Agent 的底层逻辑和落地价值，帮你从零搞懂这款新一代开源Agent框架。

1. Hermes Agent概述

1.1 什么是 Hermes Agent

Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架。它可以运行在终端、桌面应用、消息平台（Telegram、Discord、Slack 等 23+ 个平台）中，自主调用工具完成任务。

本质上一个拥有内置学习循环的自主 AI Agent：它会从经验中创造技能、在使用过程中自我改进、搜索自己的历史对话获取上下文、并跨会话建立你的用户画像。

它可以跑在一台 $5 的 VPS 上、GPU 集群里，或者按需启停的无服务器基础设施上（Modal、Daytona）。它不绑定在你的笔记本上——你可以从 Telegram 跟它聊天，而它正在一台云 VM 上工作。

1.2 核心亮点

技能自进化：Agent 解决复杂问题后，会将可复用流程保存为 Skill 文件。Skill 是透明的、人类可读可编辑的。随着时间推移，Agent 构建起一套针对你个人用例的技能库
跨会话持久记忆：不像无状态 Agent 每次对话从零开始，Hermes 跨会话保存关键信息，建立个性化用户画像——用得越多越聪明
多平台 Gateway：同一个 Agent 在 Telegram、Discord、Slack、微信等 23+ 个平台上运行，拥有完整工具访问权限
Profile 多实例：运行多个互相隔离的 Hermes 实例，各有独立的配置、会话、技能和记忆
可扩展：插件系统、MCP 服务器、自定义工具、Webhook 触发、定时任务
自维护 Curator：后台自动审查 Agent 创建的本地址能，合并重叠、归档过时条目，防止技能库无限膨胀

2. 基本使用

Hermes Desktop 是官方推出的原生桌面应用（基于 Electron），macOS、Linux、Windows 全平台支持。它是对 CLI 和 TUI 模式的补充——不需要打开终端，拥有完整的图形化界面和中文支持。

安装：从 Hermes Desktop 下载页面下载对应平台的安装包，一键安装。应用内支持自动更新

Hermes Desktop 底层仍然调用同一个 hermes 引擎，所有配置、会话、技能、记忆与 CLI/TUI 模式完全共享。你可以白天在 Desktop 上聊天，晚上在终端里跑自动化 Cron 任务——使用的是同一套数据。

2.1 交互对话(终端)

bash
hermes                       # 启动交互式对话
hermes --tui                 # 使用 TUI 启动（v0.11+，React/Ink 终端界面）

TUI 模式（v0.11+）提供：

实时 token 流式输出
每轮对话耗时统计
子 Agent 可观测性面板
多会话管理
固定输入栏（类似聊天应用）

2.2 单次对话（非交互式）

bash
hermes chat -q "查看系统资源占用情况"

适合脚本调用或一次性任务。

诊断

bash
hermes doctor                # 检查环境健康状态，诊断潜在问题

2.3 常用快捷键(windows)

快捷键	功能
`Alt + V`	从剪贴板粘贴图像
`Ctrl + C`	中断当前操作
`Ctrl + D`	退出会话
`Ctrl + Z`	暂停并挂起到后台，`fg` 恢复
`Alt + Enter`	插入新行，输入多行文本
`Ctrl + J`	插入新行，输入多行文本
`Shift + Enter`	插入新行，需终端支持独立按键序列

2.4 更新

bash
hermes update

建议：升级前备份 ~/.hermes/auth.json 和 ~/.hermes/config.yaml。大版本升级时建议直接跳到最新补丁版本（如 v0.15.1 而非 v0.15.0）。

2.5 卸载

bash
hermes uninstall

如需完全清理所有数据：

bash
# Linux / macOS / WSL2
rm -rf ~/.hermes

# Windows
Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes

3. 配置文件与配置管理

3.1 配置文件目录

plaintext
~/.hermes/
├── config.yaml        # 主配置文件（模型、终端、TTS、压缩等）
├── .env               # API 密钥和机密信息
├── auth.json          # OAuth 提供商凭证（Nous Portal 等）
├── SOUL.md            # 主 Agent 的身份 / 人格文件，会拼入系统提示词开头部分
├── memories/          # 持久化记忆（MEMORY.md、USER.md）
├── skills/            # 技能
├── cron/              # 定时任务
├── sessions/          # 会话
└── logs/              # 日志（errors.log、gateway.log — 密钥自动脱敏）

3.2 配置管理命令

bash
hermes config                        # 查看当前配置
hermes config edit                   # 用 $EDITOR 打开 config.yaml 编辑
hermes config set section.key value  # 直接设置某个配置项

会话内也可以通过斜杠命令调整部分配置：

命令	功能
`/config`	查看当前配置
`/model [model-name]`	查看或切换当前会话使用的模型
`/personality [name]`	切换预设交互风格 / 人格
`/reasoning [level/show/hide]`	调整或查看模型推理级别
`/voice [on/off/tts/status]`	开启、关闭或查看语音输入 / TTS 输出状态
`/yolo`	切换绕过确认模式，减少工具执行确认；只建议在可信环境和低风险任务使用

3.3 Provider 体系详解

Hermes 支持 20+ 模型提供商，通过 hermes model 交互切换，无需修改代码。这是 Hermes 区别于大多数 Agent 框架的核心优势之一——完全不被任何单一模型厂商锁定。

3.3.1 主要提供商一览

提供商	接入方式	特点
Nous Portal	OAuth	首选；400+ 模型，统一计费
Anthropic	API Key / OAuth PKCE	Claude 系列；自动发现 Claude Code 凭证；支持 Prompt Caching
OpenAI	API Key	GPT-5 系列，Chat Completions + Codex Responses API
OpenRouter	API Key	200+ 模型统一网关
AWS Bedrock	IAM	原生 Converse API；模型发现；Guardrails
Google Gemini	CLI OAuth	通过 Google 账号授权
xAI / Grok	API Key / OAuth Proxy	Web Search 插件；TTS 语音合成；模型退役自动检测
DeepSeek	API Key	高性价比
GitHub Copilot	OAuth	400K 上下文窗口
Hugging Face	API Key	HF Inference API，精选 Agent 模型选择器
NVIDIA NIM	API Key	托管或自托管端点
LM Studio	本地	原生本地提供商
MiniMax、Kimi/Moonshot、z.ai/GLM	API Key	国内厂商
自定义端点	API Key	任何 OpenAI 兼容 API