Hermes Agent 完整指南：从安装到精通

liuguizhong

479人浏览 · 2026-05-11 16:53:20

liuguizhong · 2026-05-11 16:53:20 发布

什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开源的 AI Agent 框架。它不是那种"问一句答一句"的普通 AI 助手——它能记住你是谁、你的偏好、你的工作环境，而且越用越聪明，可以自主进化。

简单来说，Hermes 是一个住在你终端里的智能体：

它能执行代码、操作文件、浏览网页
它能记住你上次聊了什么，不用每次重新介绍自己
它能定时执行任务，即使你不在电脑前
它能同时出现在你的 Telegram、Discord、Slack、微信等 10+ 个平台上

为什么选择 Hermes？

特性	Hermes	Claude Code	OpenClaw	Codex
跨会话持久记忆	✅ 自动	⚠️ 部分	✅	⚠️ 部分
定时任务（自托管）	✅	❌	✅	❌
多平台消息接入	✅ 10+ 平台	⚠️ 预览中	✅ 15+ 平台	❌
Web UI	✅	❌	⚠️ 仪表盘	❌
自我进化技能	✅	❌	⚠️ 社区市场	❌
多模型支持	✅ 20+ 提供商	❌ 仅 Claude	✅	✅
开源	✅ MIT	❌	✅ MIT	✅

一句话总结： Claude Code 是最强的编程 Agent，但 Hermes 是最全面的"全栈"Agent——它不只会写代码，还能帮你管理生活、监控数据、自动执行各种任务。

第一部分：安装

前置要求

操作系统： macOS / Linux / WSL2（Windows 通过 WSL2）
Python： 3.10+
API Key： 至少一个 AI 模型提供商的 API Key

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

这条命令会自动完成：

下载 Hermes Agent 源码
创建 Python 虚拟环境
安装所有依赖
运行配置向导

方式二：手动安装

# 1. 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent

# 2. 创建虚拟环境并安装依赖
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# 3. 运行配置向导
hermes setup

验证安装

看到所有检查项都通过（绿色），就说明安装成功了。

第二部分：配置模型

Hermes 支持 20+ 个 AI 模型提供商。你不需要锁定某一家，随时可以切换。

配置方式

API Key 设置

在 ~/.hermes/.env 文件中添加你的 API Key：

# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxx

# OpenAI  
OPENAI_API_KEY=sk-xxxxx

# DeepSeek
DEEPSEEK_API_KEY=sk-xxxxx

第三部分：基础使用

终端交互（CLI）

常用斜杠命令

在交互式聊天中输入以下命令：

实际使用示例

示例 1：代码开发

你：帮我写一个 FastAPI 的用户认证系统，支持 JWT
Hermes：（自动创建项目文件、安装依赖、写代码、运行测试）

示例 2：数据分析

你：分析 /data/sales.csv 的销售趋势，生成图表
Hermes：（读取文件、用 pandas 分析、用 matplotlib 画图）

示例 3：自动化任务

你：每天早上 9 点检查我的服务器状态，如果有异常发邮件通知我
Hermes：（创建定时任务，自动执行监控）

第四部分：Web UI（图形界面）

如果你不喜欢终端操作，Hermes 提供了一个漂亮的 Web 界面。

安装 Web UI

启动后访问：http://localhost:8787

Web UI 功能

三栏布局： 左侧会话列表、中间聊天、右侧文件浏览
会话管理： 搜索、置顶、归档、分组
文件操作： 浏览、编辑、创建、删除
定时任务： 可视化创建和管理 cron 任务
技能管理： 浏览、安装、编辑技能
记忆编辑： 直接编辑持久化记忆
移动端适配： 手机上也能完美使用

手机访问（通过 Tailscale）

# 1. 安装 Tailscale（服务器和手机都装）
# 2. 启动 Web UI 并监听所有接口
HERMES_WEBUI_HOST=0.0.0.0 HERMES_WEBUI_PASSWORD=你的密码 ./start.sh

# 3. 手机浏览器打开
http://<服务器Tailscale IP>:8787

第五部分：核心功能详解

1. 持久化记忆

Hermes 的灵魂特性。它会记住：

你是谁（名字、偏好、工作环境）
你的项目和工作流程
你纠正过它什么

记忆存储在 ~/.hermes/ 目录下：

~/.hermes/
├── MEMORY.md      # Agent 的笔记（技术细节、工具用法）
├── USER.md        # 关于你的信息
├── config.yaml    # 主配置文件
├── .env           # API Keys
├── skills/        # 技能文件
└── sessions/      # 会话记录

查看记忆：

hermes memory status

2. 技能系统（Skills）

技能是 Hermes 的"肌肉记忆"。当它学会一个复杂操作后，会自动保存为技能文件，下次直接复用。

3. 定时任务（Cron Jobs）

让 Hermes 在指定时间自动执行任务。

4. 多平台消息接入

Hermes 可以同时出现在你的多个聊天平台上。

支持的平台：

Telegram、Discord、Slack、WhatsApp、Signal
Email、微信（通过 WeCom）、飞书、钉钉、Matrix

5. 多 Agent 协作

Hermes 可以调用其他 AI Agent 来完成特定任务。

# 让 Claude Code 写一个功能
hermes chat -q "用 Claude Code 帮我写一个 REST API"

# 或者在聊天中
你：帮我把这个任务交给 Claude Code 处理
Hermes：（自动启动 Claude Code 子进程，完成后汇报结果）

第六部分：高级配置

配置文件详解

主配置文件：~/.hermes/config.yaml

环境变量速查

# 核心路径
HERMES_HOME=~/.hermes           # 主目录
HERMES_CONFIG_PATH=~/.hermes/config.yaml

# 模型 API Keys
ANTHROPIC_API_KEY=sk-ant-xxxxx
OPENAI_API_KEY=sk-xxxxx
DEEPSEEK_API_KEY=sk-xxxxx
GOOGLE_API_KEY=xxxxx

# Web UI
HERMES_WEBUI_PORT=8787
HERMES_WEBUI_PASSWORD=your-password
HERMES_WEBUI_HOST=127.0.0.1

Profile（多配置）

如果你想为不同项目使用不同的配置，可以用 Profile：

第七部分：实战场景

场景 1：个人编程助手

hermes

你：创建一个 Python 项目，实现一个简单的 REST API
    使用 FastAPI，包含用户注册和登录功能
    要求：JWT 认证、SQLite 数据库、密码加密

Hermes：（自动创建项目结构、写代码、安装依赖、运行测试）

场景 2：每日信息汇总

# 创建定时任务
hermes cron create "0 8 * * *" -p "
1. 检查我的邮件，总结重要邮件
2. 搜索 AI 领域的最新新闻
3. 检查我的 GitHub 项目的 issue 和 PR
4. 生成一份简报发送到我的 Telegram
"

场景 3：代码审查助手

你：审查这个 PR 的代码质量
    https://github.com/user/repo/pull/123

Hermes：（自动拉取 PR 代码、分析变更、检查安全问题、给出建议）

场景 4：数据分析管道

你：每天凌晨 2 点自动运行数据分析脚本
    脚本路径：/home/user/scripts/analyze.py
    如果发现异常数据，发邮件通知 admin@example.com

Hermes：（创建 cron 任务，设置邮件通知）

场景 5：多平台同步

# 配置 Telegram
hermes gateway setup

# 之后你可以在 Telegram 上直接和 Hermes 聊天
# 它会保持和终端一样的记忆和上下文

第八部分：常见问题

Q: Hermes 和 Claude Code 有什么区别？

Claude Code： 专注于编程，是最强的代码 Agent。适合纯开发场景。

Hermes： 全栈 Agent，除了编程还能做数据分析、自动化、定时任务、多平台通讯等。适合需要一个"全能助手"的场景。

最佳实践： 用 Hermes 做日常管理和调度，编程任务交给 Claude Code 执行。

Q: 我需要什么硬件？

最低要求： 任何能跑 Python 的电脑
推荐配置： 4GB+ 内存
如果用本地模型： 需要 GPU（NVIDIA 8GB+ 显存）

Q: 数据安全吗？

Hermes 是完全本地运行的，你的数据不会上传到任何第三方服务器。API 调用直接发送到你选择的模型提供商，中间没有转发。

Q: 可以免费使用吗？

Hermes 本身是开源免费的（MIT 许可证）。但使用云模型 API（如 Claude、GPT-4）需要付费。如果用本地模型（通过 Ollama），则完全免费。

第九部分：进阶技巧

技能开发

你可以创建自己的技能文件，让 Hermes 学会新的操作：

~/.hermes/skills/
├── github/
│   └── my-custom-skill/
│       └── SKILL.md    # 技能文档
└── ...

技能文件使用 Markdown 格式，包含：

触发条件
执行步骤
错误处理
验证方法

记忆优化

Hermes 的记忆系统会自动管理，但你可以手动优化：

# 查看记忆状态
hermes memory status

# 重置记忆（谨慎使用）
hermes memory reset

# 导出记忆
hermes memory export > my_memory.json

性能调优

在 config.yaml 中调整：

# 减少 token 消耗
compression:
  enabled: true
  threshold: 0.50    # 上下文使用 50% 时触发压缩
  target_ratio: 0.20  # 压缩到 20%

# 调整并发
agent:
  max_turns: 90      # 单次会话最大轮次
  tool_use_enforcement: true