主题
04-01 · Hermes Agent
Hermes Agent 是 Nous Research 开源的"自主 AI Agent 框架"，定位是 本地常驻的 Agent 大脑。它能调用 Claude Code、OpenClaw、本地 LLM 等下游执行单元，并提供持久记忆、Skill 自我进化能力。GitHub 上目前 5.3 万 + Star。
一、Hermes 解决什么
| 痛点 | Hermes 怎么解 |
|---|---|
| Claude Code 是 TUI，无法 7×24 自动跑 | Hermes 用 tmux + pty 接管，把它"喂"成可调度的工具 |
| 多个工具（Claude Code、OpenClaw、本地模型）各干各的 | Hermes 作为统一调度层 |
| 经验只在某次对话里，会丢 | Hermes 把成功的步骤抽成 Skill，下次自动复用 |
| Token 成本高 | 简单任务自动分流到本地小模型 |
类比：Claude Code 像"实习生"，Hermes 像"项目经理"。一个干活，一个调度 + 沉淀经验。
二、安装
下面以 macOS / Linux 为例。Windows 推荐用 WSL2。
2.1 前置依赖
bash
# tmux（Hermes 必需，用来跑 TUI 工具）
sudo apt-get install -y tmux # Ubuntu / Debian
brew install tmux # macOS
# Python 3.11+
python3 --version
# git
git --version2.2 拉仓库 + 安装
bash
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
# 推荐用 uv（Python 包管理）
pip install uv
uv sync
# 或用传统 pip
python3 -m venv .venv
source .venv/bin/activate
pip install -e .2.3 配置模型 / 工具
复制示例配置：
bash
cp .env.example .env编辑 .env，至少配一个主控大脑：
ini
# 主控 LLM（推荐 Claude Sonnet 4.5 或 GPT-5）
ANTHROPIC_API_KEY=sk-ant-xxx
# 或
OPENAI_API_KEY=sk-xxx
# 可选：本地 Ollama（用于分流简单任务）
OLLAMA_BASE_URL=http://localhost:114342.4 启动
bash
hermes第一次启动会引导你做：
- 选默认主控模型
- 是否检测已安装的 Claude Code / OpenClaw / Codex
- 是否导入它们的配置作为子工具
如果你已经装了 OpenClaw / Claude Code，Hermes 会自动识别并询问"是否导入配置"。选是。
三、最小流程：用 Hermes 调度 Claude Code 干活
启动 Hermes 后，输入：
> 我有一个 React 项目在 ~/projects/my-app，请用 Claude Code 给所有组件加上 TypeScript 类型定义，跑通后 commit。Hermes 会：
- 规划：列出待办（找组件 → 加类型 → 跑 build → commit）
- 在 tmux 会话里启动 Claude Code 子进程
- 把每一步任务转成给 Claude Code 的 prompt
- 监控输出 / 处理错误 / 必要时切换工具
- 完成后总结：哪些做了、哪些没做、用了多少 Token
四、Hermes 的 Skill 自我进化
这是 Hermes 真正的杀手锏。
4.1 怎么工作的
- 你跑了一个任务 → Hermes 记下完整轨迹
- 第二次遇到类似任务 → Hermes 检测相似度
- 把成功的步骤抽成新 Skill（保存到
~/.hermes/skills/） - 第三次起 → 自动加载 Skill，速度 / 准确率明显提升
4.2 你能看到什么
bash
ls ~/.hermes/skills/
# 例如：
# - go-concurrent-fix/ ← 你之前修过的并发 bug
# - react-ts-migration/ ← 你之前做过的 TS 迁移
# - api-rate-limit-debug/ ← 你之前调过的限流问题每个 Skill 都遵循 Anthropic Agent Skills 规范，可直接复制给 Claude Code / OpenClaw 用。
公司心法：定期把
~/.hermes/skills/里的精品 Skill 提交到公司qdy-skills仓库，让团队复用。
五、与 Claude Code / OpenClaw 协同
Hermes 与 Claude Code 有两种交互模式：
| 模式 | 何时用 | 配置 |
|---|---|---|
| Interactive（tmux + pty） | Claude Code 是 TUI 应用，必须用这种 | Hermes 默认 |
One-shot（claude -p） | 简单单步任务 | pty=false |
Hermes 官方 Skill 文档明确说：要让 Hermes 控制 Claude Code v2.x，必须用 tmux + pty。单纯 pty=true 会因为 TUI 渲染问题崩。
六、Hermes vs OpenClaw vs Claude Code
| 维度 | Hermes | OpenClaw | Claude Code |
|---|---|---|---|
| 定位 | 本地 调度层 / 大脑 | 本地 多模型 AI 平台 | 终端 AI 编码助手 |
| 长期常驻 | ✅ | ✅ | ❌（按需启动） |
| 多模型 | ✅ | ✅✅ | 仅 Claude |
| Skill 自进化 | ✅✅ | ✅ | ❌（手写） |
| 适合场景 | 协调多工具的复杂工作流 | 单机 AI 平台 / 本地数据 | 代码任务 |
公司推荐组合：
- 如果你要做 Agent 流水线 → Hermes 必装
- 如果你只想要一个本地 AI 工作台 → OpenClaw 更友好
- 两者其实可以共存：Hermes 调度 OpenClaw 当作工具
七、参考资料
- 📚 Hermes Agent GitHub
- 📚 Hermes Agent 官网
- 📚 菜鸟教程 - Hermes Agent
- 📚 Hermes ↔ Claude Code 协同 Skill 文档
- 📚 实战：AI 编程"三件套"深度拆解
八、风险提示（必读）
- Hermes 团队成员有 Web3 背景，链上有非官方 NOUS 代币 —— 跟项目本身无关，不要碰。
- Token 消耗较大，简单任务记得分流到本地小模型。
- 配置有学习曲线，第一次调通大概 1-2 小时。
继续 → 02 · OpenClaw