🍊 Hermes Agent 从入门到精通 — 橙皮书精华笔记

- 

本文档整理自「花叔」（AI进化论-花生）的《Hermes Agent 从入门到精通》橙皮书 v260407，基于 Hermes Agent v0.7.0 编写。

一、这是什么书？

Hermes Agent 是 Nous Research 开源的自改进 AI Agent 框架，2026年2月发布，两个月内 GitHub Stars 飙到 27,000+。本书是第一本系统讲解这个框架的中文实战手册，关键词：

自改进 Agent · 跨会话记忆 · Skill 系统 · MCP · 多平台

二、为什么 Hermes 不是"又一个 Agent"

核心洞察：OpenClaw 给你一套「配置即行为」系统，你写 SOUL.md，手动维护；Hermes 把 Harness 五个维度全部内建，让 AI 自己给自己造缰绳。

三、Hermes 学习循环（五个环节）

飞轮效应：记忆 → 喂养 Skill → 使用产生新记忆 → 触发 Skill 改进 → 结果更好 → 用户建模更准 → 下次记忆更有针对性。正反馈闭环，用得越多越好用。

四、三层记忆架构

五、与 OpenClaw / Claude Code 横向对比

维度

Claude Code

OpenClaw

 Hermes Agent

核心理念

交互式编码

配置即行为

 自主后台 + 自改进

你的角色

坐在终端前指挥

写配置文件定义行为

 部署后偶尔检查

记忆机制

CLAUDE.md + auto-memory

SOUL.md + Daily Logs（人工维护）

 三层自改进记忆

Skill 来源

手动安装

ClawHub 44,000+

 Agent 自创 + 社区 Hub

运行模式

按需启动

按需启动

 24/7 后台运行

部署方式

本地 CLI（订阅制）

本地 CLI（免费+API费）

 $5 VPS / Docker / Serverless

学习能力

不学习，规则靠人写

依赖社区主动维护

 从你的反馈中自动学习

一句话区分：OpenClaw 是你养出来的龙虾，Hermes 是自己会长大的龙虾。

六、关键数据

指标

数值

GitHub Stars（发布2个月）

 27,000+

内置工具数量

 40+

支持消息平台

 12+

MCP 可接入应用

 6,000+

子 Agent 并发上限

 最多 3 个

最低部署成本

 $5/月 VPS

内存占用（不跑本地LLM）

 < 500MB

许可证

 MIT（完全开源）

七、安装方式

方式一：一键安装（推荐）

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

方式二：手动安装

curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"

方式三：Docker

docker pull ghcr.io/nousresearch/hermes-agent:latest
docker run -v ~/.hermes:/opt/data hermes-agent

八、核心配置 config.yaml

# ~/.hermes/config.yaml
model:
provider:openrouter       # 模型提供商
api_key:sk-or-xxxxx       # 你的 API Key
model:anthropic/claude-sonnet-4# 使用的模型

terminal:local              # 终端后端（local/docker/ssh/daytona/modal）

gateway:                     # 消息网关（可选）
telegram:
    token:YOUR_BOT_TOKEN
discord:
    token:YOUR_BOT_TOKEN

配置极简设计：一个 config.yaml 搞定所有事，不搞分散的环境变量和多层配置文件。

九、支持的模型提供商

Provider

推荐模型

适用场景

OpenRouter

Claude Sonnet 4 / GPT-4o

200+ 模型可选，灵活切换

Nous Portal

Hermes 3 系列

官方推荐，深度适配

OpenAI

GPT-4o / o3

直连 OpenAI API

z.ai / 智谱

GLM-5

国内用户友好

Ollama

Hermes 3 8B/70B

完全离线，隐私优先

Kimi / Moonshot

-

超长上下文

MiniMax

-

国内可用

⚠️ 注意：2026年4月起，Anthropic 封禁了第三方工具通过 Claude 订阅（Pro/Max）访问。Hermes 等 Agent 框架受影响。建议优先使用 OpenRouter 或 Nous Portal 的 Hermes 3 系列。

十、六种终端执行后端

后端

场景
local

直接在本机运行，最简单
docker

容器内运行，隔离安全
ssh

连接远程服务器
daytona

Serverless，按需唤醒
modal

云执行，空闲时成本几乎零
singularity

HPC 集群环境

十一、Skill 系统详解

什么是 Skill

Skill 就是 ~/.hermes/skills/ 下的一个 Markdown 文件，用自然语言描述特定场景的行为规则。不需要代码，不需要 API，就是文字。

好 Skill 的结构

部分

作用

必须?

标题

让 Hermes 快速识别用途

✅

触发条件

什么时候激活

强烈建议

行为规则

具体步骤、约束、格式

✅

示例

完整输入→输出示例

强烈建议

不要做什么

明确边界，防止漂移

可选

示例 Skill 文件

# Git Commit Style

## 触发条件
当用户让我提交代码、写 commit message、或 review 提交历史时激活。

## 行为规则
### Commit Message 格式
- 第一行：类型(范围): 简述（不超过50字符）
- 空一行
- 正文：解释为什么改，而非改了什么

### 类型枚举
- feat: 新功能
- fix: 修复 bug
- refactor: 重构
- docs: 文档

## 示例
feat(auth): 支持微信扫码登录

之前只能用手机号登录，流程太长。现在直接扫码登录，未绑定手机号的用户会自动创建账号。

Skill 创建三种途径

  1. Agent 自动创建：复杂任务完成后，Hermes 自动提炼为 Skill

  2. 手动编写：在 ~/.hermes/skills/ 创建 .md 文件

  3. 从社区安装：通过 agentskills.io / Skills Hub 安装

从 Claude Code 迁移 Skill

直接把 SKILL.md 文件复制到 ~/.hermes/skills/，Hermes 可以直接使用——因为两者都采用 agentskills.io 标准（Markdown 格式）。Skill 不再绑定某个工具，是你自己的可移植资产。

十二、MCP 集成

配置方式

# stdio 方式（本地工具，推荐）
mcp_servers:
github:
    command:"npx"
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN:"ghp_xxxxx"

# HTTP 方式（远程服务器）
mcp_servers:
remote-tools:
    url:"https://your-server.com/mcp"
    transport:"sse"

接入 GitHub MCP 实战

  1. 生成 GitHub Token（勾选 repo, read:org, issues, pull_requests）

  2. 在 config.yaml 里添加 GitHub MCP Server

  3. 重启 Hermes，说「列出我 GitHub 上的仓库」验证

接入后 Hermes 可以：创建 Issue、提 PR、审查代码、管理项目面板

十三、多平台接入 Gateway

Hermes 的 Messaging Gateway 是一个统一网关进程，同时监听所有已配置平台，共享同一个 Agent 实例、同一套记忆、同一组 Skill。

Telegram Bot 配置（最简单，3步2分钟）：

# 1. @BotFather 获取 Token
# 2. 填入 config.yaml
gateway:
  telegram:
    token: 123456789:ABCdefGhIJKlmNoPQRsTUVwxyz
# 3. hermes 启动即自动连接

支持的 12+ 平台：

平台

特点

Telegram

配置最简单，支持语音消息自动转写

Discord

适合团队协作

Slack

企业场景，IT友好

WhatsApp

一级支持

Signal

隐私优先

飞书 / 企业微信 / 钉钉

国内企业

Home Assistant

智能家居控制

Email / SMS

传统通道

跨平台连续性：从 Telegram 发消息让 Hermes 调研，到办公室打开终端接着聊，所有平台共享同一个大脑。

十四、多 Agent 编排（delegate_task）

核心能力

特性

说明

独立上下文

子 Agent 有自己的对话历史，不污染主上下文

受限工具集

可指定子 Agent 只能使用哪些工具

独立终端会话

每个子 Agent 有自己的终端

并发上限 3 个

硬编码限制，防止资源耗尽、注意力分散

结果回传

子 Agent 完成后结果返回主 Agent 汇总

竞品分析报告实战案例

主 Agent
├── 子 Agent A → 调研 Claude Code（仅 web + browser 权限）
├── 子 Agent B → 调研 Cursor（仅 web + browser 权限）
└── 子 Agent C → 调研 Hermes（仅 web + browser 权限）
           ↓
      主 Agent 汇总，生成对比报告

效果：40分钟的竞品分析，实测15分钟完成。

安全原则：最小权限

  • 调研子 Agent：只给 web + browser

  • 编码子 Agent：只给 terminal + file + code_execution

  • 汇总子 Agent：什么外部工具都不给，只处理文本

十五、部署方案总览

$5 VPS (Ubuntu 22.04)
├── Hermes Agent 核心
├── Messaging Gateway
│   ├── Telegram Bot（手机随时可达）
│   ├── Discord Bot（团队协作）
│   └── Slack App（企业场景）
├── ~/.hermes/
│   ├── state.db（所有对话历史 + FTS5 索引）
│   ├── skills/（自动积累的能力）
│   └── config.yaml（一个文件搞定）
└── 模型调用 → OpenRouter API

总成本：VPS  月 模 型 调 用 费 （ 轻 度 使 用 2-5/月）= 不到一杯精品咖啡

十六、三种工具的场景分工

场景

推荐工具

理由

写新功能、重构代码

Claude Code

需要实时反馈和人的判断

给团队搭标准化 Agent

OpenClaw

SOUL.md 透明可审计可复制

7x24 代码审查

Hermes

cron 调度 + GitHub MCP，无人值守

个人知识助手

Hermes

三层记忆跨会话积累，越用越懂你

快速验证产品想法

Claude Code

启动快、迭代快

高度可控的企业场景

OpenClaw

配置透明，行为可预测

长期内容创作项目

 Hermes + Claude Code

Hermes 持续调研积累，Claude Code 写稿

花叔的判断：不要在三个工具之间做"选择"，而是组合。Claude Code 是"白天团队"，Hermes 是"夜班团队"。

十七、自改进的边界与风险

技术层面的约束（受控）

  • Skill 文件是可读的 Markdown，改了什么能看到 diff

  • 记忆数据在本地 SQLite，可直接查看和删除

  • 工具权限有沙箱，Agent 不能随意获取新权限

现实层面的挑战

矛盾本质：自主 Agent 的价值在于你不用盯着，但安全需要你盯着。

  • "你能看到代码" ≠ "你看了代码"

  • 绝大多数用户会用默认配置，不会每天审查 Skill 改动

  • Agent 不知道自己不知道什么，领域方向判断仍需人参与

花叔的结论

让 Agent 在「怎么做」上自改进，你只管「做什么」和「别做什么」。这不是偷懒，是另一种 on the loop。

十八、文档与社区资源

资源

链接

GitHub 仓库

NousResearch/hermes-agent[1]

官方文档

hermes-agent.nousresearch.com/docs[2]

Skills Hub

agentskills.io[3]

社区 Discord

discord.gg/NousResearch[4]

作者 B站

AI进化论-花生

作者公众号

花叔

📌 本文档整理自：花叔《Hermes Agent 从入门到精通》橙皮书 v260407 | 基于 Hermes Agent v0.7.0

引用链接

[1]NousResearch/hermes-agent: https://github.com/NousResearch/hermes-agent

[2]hermes-agent.nousresearch.com/docs: https://hermes-agent.nousresearch.com/docs/

[3]agentskills.io: https://agentskills.io

[4]discord.gg/NousResearch: https://discord.gg/NousResearch

Logo
DeepSeek技术社区

欢迎加入DeepSeek 技术社区。在这里，你可以找到志同道合的朋友，共同探索AI技术的奥秘。

更多推荐

2026年07月07日全球AI前沿动态

AI技术密集爆发与产业融合（2026年7月关键进展） 技术突破：通用大模型领域，腾讯混元Hy3（MoE架构）、Claude系列（J-space神经发现）、GPT-5.6（多层级版本）等竞相迭代，性能与成本优势显著；垂直模型如OpenScience科研工具、MMAT数学智能体等加速专业化；3D生成、机器人操作、算法优化（如SeKV显存优化）等技术取得实质进展。 产业落地：国内政策规范与商业化并行，腾

avatar DeepSeek技术社区

Gemini 2.5 Flash Lite 新手极速上手指南

在开发智能应用时，很多开发者常常面临一个两难选择：是追求模型的强大理解能力，还是担心高昂的算力成本和复杂的部署流程？特别是在处理长文档分析、图片内容识别或需要实时交互的场景下，传统方案往往显得力不从心。要么响应速度慢得让人失去耐心，要么在处理复杂上下文时出现“遗忘”现象，导致回答断章取义。其实，随着新一代大模型 API 的成熟，这些问题已经有了更优雅的解法。不需要自己搭建庞大的服务器集群，也不必深

avatar DeepSeek技术社区

从提示词工程到上下文工程：ChatGPT 和 Codex 真正改变的是软件系统的组织方式

上下文工程，可以理解为：如何为 AI 提供正确、完整、可执行、可验证的任务背景。它不是简单地把更多文字塞给模型，而是把任务相关的信息组织成一种结构。Context├── Goal 任务目标├── State 当前状态├── Constraints 约束条件├── Resources 可用资源└── Verification 验证标准├── user_intent 用户意图├── repo_stru

avatar DeepSeek技术社区