![](data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32"><text y="28" font-size="28">🤑</text></svg>)
模块一：入门篇 — Hermes Agent 介绍、安装与配置
学习理念：在理解 Nous Research 理念和 Hermes Agent 架构的基础上，亲手完成安装配置和首次对话。 海外对标：对标 Anthropic Claude Code / OpenAI Codex CLI 的安装部署流程。
本节 AI 替代率：~20% | 人工干预率：~80%
角色 能力范围 🤖 AI 擅长 安装脚本执行、配置命令补全、错误诊断 👤 人类需理解 开源理念、Provider 选型策略、配置安全、版本差异
目录
1. Nous Research 公司介绍
1.1 创立与理念
Nous Research 是一家开源 AI 研究实验室，2023 年成立于美国德克萨斯州奥斯汀。最初的成员是一群在社交媒体上结识的志愿者 AI 研究员，他们怀着一个共同的信念：打造透明、无限制的开源 AI，挑战 OpenAI、Anthropic 等闭源巨头的垄断格局。
公司名称 "Nous" 源自古希腊哲学概念 νοῦς（nous），意为"直觉"或"心智"——这个名字准确地传达了他们的使命：创造真正理解人类意图、服务于个体自由的智能。
"超级智能应当服务于最大化的个体自主性和精神自由。它的发展不能只掌握在少数公司和寡头手中。" — Nous Research 官方宣言
Nous Research 的核心理念可以概括为三个关键词：
- 开源（Open Source）：所有模型、代码、数据集公开，社区可自由使用、修改、分发
- 无限制（Unrestricted）：模型拒绝率仅约 40%（商业模型通常 95% 以上），最大限度保留模型的回答能力
- 人类对齐（Human-Aligned）：不是"安全对齐"（拒绝回答），而是让模型忠实执行用户意图
1.2 创始团队
| 姓名 | 角色 | 背景 |
|---|---|---|
| Jeffrey Quesnelle (JQ) | 联合创始人 & CEO | 软件工程、数学、密码学背景 |
| Karan Malhotra | 联合创始人 & 行为负责人 | 专注模型对齐，活跃于去中心化 AI 和加密领域 |
| Ryan Teknium | 联合创始人 & 后训练负责人 | 开源 LLM 微调领域最活跃的贡献者之一，Hermes 模型系列创建者 |
| Diederik Kingma | 团队成员 | Adam 优化器共同发明人，深度学习基础领域的标志性人物 |
1.3 融资历程
| 轮次 | 金额 | 领投方 | 估值 | 时间 |
|---|---|---|---|---|
| 种子轮 | $20M | OSS Capital、Distributed Global 等 | — | 2024 年 1 月 |
| A 轮 | $50M | Paradigm（顶级加密 VC） | $1B（代币估值） | 2025 年 4 月 |
| 合计 | $70M |
值得关注的是，A 轮融资基于代币估值而非传统股权估值，反映了 Nous Research 的加密原生结构。其他投资方包括 Delphi Ventures、North Island Ventures，以及 Balaji Srinivasan、Vipul Ved Prakash 等个人投资者。
团队从 2023 年中期的 7 人增长至 2026 年的约 40 人，网站月访问量约 45 万次。
1.4 产品矩阵
Hermes 模型系列
Hermes 是 Nous Research 的旗舰开源大语言模型系列，基于 Llama 等基础架构进行高质量合成数据微调。超过 90% 的训练数据是合成的，通过内部 DataForge 管线生成，让一个小团队能在数据质量上媲美大厂。
| 模型 | 基础架构 | 核心特点 |
|---|---|---|
| Hermes 2 Pro | Llama-3 | 高质量指令微调、函数调用 |
| Hermes 2 Theta | Llama-3 | 增强推理、代码生成 |
| Hermes 3 | Llama 3.1 70B | 更高表现力、长链思考、个性化对齐 |
| Hermes 4 / 4.3 | 最新 | 90% 合成数据；~60% 非拒绝率；MATH 超 Meta Llama Instruct 约 60 分 |
| DeepHermes-3 | — | 快速响应与思维链推理两种模式自由切换 |
| NousCoder-14B | — | 代码竞赛型模型，LiveCodeBench v6 Pass@1 达 67.87% |
DisTrO — 分布式训练优化器
DisTrO（Distributed Training Over-the-Internet Optimizer）是 Nous Research 自研的分布式训练协议，能将训练过程中的数据传输量降低 3~4 个数量级（最高 10,000 倍效率提升）。它使用 DeMo（Decoupled Momentum Optimization，解耦动量优化）算法，在保持模型精度的同时大幅降低带宽需求，让跨地域、消费级网络环境下的分布式训练成为现实。
2024 年 12 月，团队直播演示了用纯分布式、去中心化硬件成功预训练一个 15 亿参数模型，证明了技术可行性。
Psyche Network — 去中心化训练网络
Psyche 是构建在 Solana 区块链上的去中心化 AI 训练基础设施。它协调全球贡献者的分布式 GPU 算力（从 NVIDIA 4090 到 A100、H100），通过代币激励模型奖励算力提供者。目前处于测试阶段，已开始在 Seed-OSS-36B 模型上进行 Hermes 4 的消融实验和训练。
其他产品
| 产品 | 说明 |
|---|---|
| Hermes Agent | 本教程主题，开源自进化 AI Agent 框架 |
| Hermes Desktop | Electron 原生桌面应用（v0.16 公测） |
| Forge Reasoning API | 云端推理 API，支持 MCTS、Chain of Code、Mixture of Agents |
| Nous Chat | 免费 Web 聊天界面（hermes.nousresearch.com） |
| Hermes-Function-Calling | 专用 LLM 函数调用库 |
1.5 市场定位
在开源 AI 生态中，Nous Research 的定位清晰：
| 组织 | 开放度 | 代表作品 |
|---|---|---|
| Nous Research | ★★★★★ | Hermes、Psyche、DisTrO |
| Meta AI | ★★★★ | Llama |
| Hugging Face | ★★★★★ | Transformers |
| Anthropic | ★★★ | Claude |
| OpenAI | ★★ | GPT 系列 |
2. Hermes Agent 项目概述
官方文档：https://hermes-agent.nousresearch.com/docs GitHub：https://github.com/NousResearch/hermes-agent
2.1 什么是 Hermes Agent
Hermes Agent 是由 Nous Research 开发的开源 AI Agent 框架。它可以运行在终端、桌面应用、消息平台（Telegram、Discord、Slack 等 23+ 个平台）中，自主调用工具完成任务。
本质上一个拥有内置学习循环的自主 AI Agent：它会从经验中创造技能、在使用过程中自我改进、搜索自己的历史对话获取上下文、并跨会话建立你的用户画像。
它可以跑在一台 $5 的 VPS 上、GPU 集群里，或者按需启停的无服务器基础设施上（Modal、Daytona）。它不绑定在你的笔记本上——你可以从 Telegram 跟它聊天，而它正在一台云 VM 上工作。
2.2 发展历程
| 时间 | 里程碑 |
|---|---|
| 2024 年中 | Hermes Agent 项目启动 |
| 2025.2 | 首次开源发布，GitHub 首月获 2.2K stars |
| 2025.4 | 从 OpenClaw 推出一键迁移工具，抓住 Anthropic 政策变化带来的用户迁移潮 |
| 2026.4 | v0.10.0，引入 Tool Gateway，发布 400+ 模型 |
| 2026.5 | v0.13~0.15 密集迭代：Kanban 持久化、TUI、代码重构、Swarm |
| 2026.6 | v0.16.0 "Surface"，Hermes Desktop 公测，原生桌面体验 |
| 🆕 2026.6.19 | v0.17.0 "Reach"，背景子 Agent、Desktop 大幅增强、memory atomic batch、iMessage + Raft 网络 |
| 🆕 2026.7.1 | v0.18.0 "Judgment"→ MoA 一等公民、/learn、/journey、背景扇出委派、证据验证、Desktop Projects |
🟢 GitHub Stars 超过 208K（截至 v0.18.0），是最活跃的开源 Agent 项目之一。
2.3 核心亮点
- 技能自进化：Agent 解决复杂问题后，会将可复用流程保存为 Skill 文件。Skill 是透明的、人类可读可编辑的。随着时间推移，Agent 构建起一套针对你个人用例的技能库
- 跨会话持久记忆：不像无状态 Agent 每次对话从零开始，Hermes 跨会话保存关键信息，建立个性化用户画像——用得越多越聪明
- 多平台 Gateway：同一个 Agent 在 Telegram、Discord、Slack、微信等 23+ 个平台上运行，拥有完整工具访问权限
- Profile 多实例：运行多个互相隔离的 Hermes 实例，各有独立的配置、会话、技能和记忆
- 可扩展：插件系统、MCP 服务器、自定义工具、Webhook 触发、定时任务
- 自维护 Curator：后台自动审查 Agent 创建的本地址能，合并重叠、归档过时条目，防止技能库无限膨胀
- 🆕 MoA 一等公民（v0.18）：预定义模型委员会可直接作为可选模型，CLI/TUI/Desktop/Gateway 均可使用
- 🆕
/learn+/journey（v0.18）：一句话从目录/URL/对话提取 Skill；可视化查看 Agent 学习时间线 - 🆕 Background fan-out（v0.18）：子 Agent 后台运行，不阻塞当前对话
2.4 与 OpenClaw 的对比
Hermes Agent 经常被拿来与 OpenClaw（"龙虾"）对比。两者都提供类似的功能，但存在关键差异：
| 维度 | Hermes Agent | OpenClaw |
|---|---|---|
| 技能存储 | 透明、人类可读的 SKILL.md 文件 | 不透明格式 |
| 自我改进 | 内置 Curator 自动维护技能库 | 无 |
| Provider 灵活性 | 20+ 提供商，400+ 模型 | 较少 |
| Windows 支持 | v0.14+ 原生支持 | 有限 |
| 桌面应用 | v0.16+ Hermes Desktop | 无 |
| 许可证 | MIT | — |
3. 快速上手
官方文档：https://hermes-agent.nousresearch.com/docs/getting-started/installation
3.1 环境要求
- Python：3.11+
- 操作系统：Linux、macOS、WSL2、Windows（v0.14+ 原生）、Android Termux
- Git：安装脚本依赖
3.2 安装
安装前请确认 git 可用。
安装脚本主要会做这些事：
- 拉取或更新 Hermes 源码。普通 Linux / macOS / WSL2 用户默认安装到
~/.hermes/hermes-agent；Windows 默认安装到%LOCALAPPDATA%\hermes\hermes-agent - 创建 Python 虚拟环境并安装依赖；必要时会安装
uv、Node.js、浏览器工具相关依赖 - 创建
hermes命令入口，并提示把它所在目录加入PATH - 初始化数据目录。Linux / macOS / WSL2 默认是
~/.hermes；Windows 默认是%LOCALAPPDATA%\hermes - 仅在文件不存在时创建
config.yaml、.env、SOUL.md，已有配置会保留 - 交互式终端中会继续运行 setup 向导
Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashWindows（PowerShell，v0.14+ 原生支持）
iex (irm https://hermes-agent.nousresearch.com/install.ps1)Windows 原生安装使用便携版 Git Bash，无需 WSL。安装后会在 %LOCALAPPDATA%\hermes\ 下创建完整运行环境。
Termux (Android)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashv0.15 冷启动优化后，Termux 环境下 hermes --version 仅需 0.8 秒。
3.3 初次配置
hermes model # 交互式选择模型和提供商
hermes setup # 或者运行完整设置向导
hermes setup --portal # 使用 Nous Portal 一键配置（推荐新用户）🆕 v0.17+ 支持三种设置模式：
| 模式 | 默认启用 | 认证 | 适用场景 |
|---|---|---|---|
| Quick Setup | 模型 + Tool Gateway | Nous Portal OAuth | 最快上手 |
| Full Setup | 所有可选 | 自带 Key | 手调、完全控制 |
| Blank Slate（⭐） | 仅 Provider + 文件 + 终端 | 仅 Provider 认证 | 最小化、完全自控 |
Blank Slate 会显式写入 platform_toolsets.cli 和 agent.disabled_toolsets，未选能力永不会加载（即使 hermes update 后）。
Nous Portal 是 v0.16 推荐的一键配置方式，提供 400+ 模型，OAuth 登录后即可使用，无需手动管理 API Key。
API Key 存储在 ~/.hermes/.env 文件中（Windows 在 %LOCALAPPDATA%\hermes\.env）。
3.4 基本使用
Hermes Desktop（v0.16+，★ 推荐新用户）
Hermes Desktop 是 v0.16 推出的原生桌面应用（基于 Electron），macOS、Linux、Windows 全平台支持。它是对 CLI 和 TUI 模式的补充——不需要打开终端，拥有完整的图形化界面和中文支持。
安装：从 Hermes Desktop 公测页面 下载对应平台的安装包，一键安装。应用内支持自动更新。
启动后的第一个界面就是模型配置：
- 支持模糊搜索模型（输入
sonnet瞬间匹配到anthropic/claude-sonnet-4） - 内置 Nous Portal OAuth 登录，400+ 模型一键切换
- 所有主流 Provider 均可通过图形界面配置 API Key
核心功能：
| 功能 | 说明 |
|---|---|
| 多标签页对话 | 同时进行多个独立会话，各自拥有独立的上下文 |
| Cmd/Ctrl+K 命令面板 | 类似 VS Code，搜索和执行任意操作 |
| 拖放文件 | 将文件拖入聊天窗口即可让 Agent 处理 |
| 剪贴板图片粘贴 | 截图后 Ctrl+V 直接粘贴到对话中 |
| Remote Gateway | 桌面应用通过 OAuth 连接到运行在云服务器上的 Hermes Gateway |
| 完整中文界面 | v0.16 正式支持简体中文 UI |
| 🆕 可绑定快捷键（v0.17+） | 可自定义的键盘快捷键 |
| 🆕 原生 OS 通知（v0.17+） | 可逐类开关的系统通知 |
| 🆕 VS Code 主题（v0.17+） | 可安装任意 VS Code Marketplace 主题 |
| 🆕 子 Agent 监听窗（v0.17+） | 实时查看委派 Agent 活动 |
| 🆕 Projects 编码项目（v0.18+） | 侧边栏代码库管理、git worktree、审查面板 |
| 🆕 Memory Graph（v0.18+） | 可视化记忆/技能辐射时间线，可直接编辑删除 |
与 CLI/TUI 的关系：Hermes Desktop 底层仍然调用同一个 hermes 引擎，所有配置、会话、技能、记忆与 CLI/TUI 模式完全共享。你可以白天在 Desktop 上聊天，晚上在终端里跑自动化 Cron 任务——使用的是同一套数据。
交互式对话（终端）
hermes # 启动交互式对话
hermes --tui # 使用 TUI 启动（v0.11+，React/Ink 终端界面）TUI 模式（v0.11+）提供：
- 实时 token 流式输出
- 每轮对话耗时统计
- 子 Agent 可观测性面板
- 多会话管理
- 固定输入栏（类似聊天应用）
单次对话（非交互式）
hermes chat -q "查看系统资源占用情况"适合脚本调用或一次性任务。
诊断
hermes doctor # 检查环境健康状态，诊断潜在问题3.5 常用快捷键
| 快捷键 | 功能 |
|---|---|
Alt + V | 从剪贴板粘贴图像 |
Ctrl + C | 中断当前操作 |
Ctrl + D | 退出会话 |
Ctrl + Z | 暂停并挂起到后台，fg 恢复 |
Alt + Enter | 插入新行，输入多行文本 |
Ctrl + J | 插入新行，输入多行文本 |
Shift + Enter | 插入新行，需终端支持独立按键序列 |
3.6 更新
hermes update建议：升级前备份
~/.hermes/auth.json和~/.hermes/config.yaml。大版本升级时建议直接跳到最新补丁版本（如 v0.15.1 而非 v0.15.0）。
3.7 卸载
hermes uninstall如需完全清理所有数据：
# Linux / macOS / WSL2
rm -rf ~/.hermes
# Windows
Remove-Item -Recurse -Force $env:LOCALAPPDATA\hermes4. 配置文件与配置管理
官方文档：https://hermes-agent.nousresearch.com/docs/user-guide/configuration
4.1 配置目录结构
~/.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 — 密钥自动脱敏）4.2 配置管理命令
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 | 切换绕过确认模式，减少工具执行确认；只建议在可信环境和低风险任务使用 |
🆕 /learn <source>（v0.18+） | 从目录/URL/对话中提取可复用技能 |
🆕 /journey（v0.18+） | 查看 Agent 学习时间线，可编辑/删除条目 |
🆕 /prompt（v0.18+） | 在 $EDITOR 中编写长提示 |
4.3 Provider 体系详解
Hermes 支持 20+ 模型提供商，通过 hermes model 交互切换，无需修改代码。这是 Hermes 区别于大多数 Agent 框架的核心优势之一——完全不被任何单一模型厂商锁定。
主要提供商一览
| 提供商 | 接入方式 | 特点 |
|---|---|---|
| Nous Portal | OAuth | 首选；400+ 模型，统一计费 |
| 🆕 MoA 委员会（v0.18+） | 内置 | 预定义模型委员会作为可选模型出现 |
| 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 账号授权 |
| 🆕 Google Vertex AI（v0.18+） | 服务账号 | GCP 服务账号自动签发+刷新 OAuth2 token，无需静态 Key |
| 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 |