全栈AI Agent保姆级教程！从安装到实战，开发者、研究者、普通用户必备！
Hermes Agent 是由 Nous Research 开源的 AI Agent 框架。它不是那种"问一句答一句"的普通 AI 助手——它能记住你是谁、你的偏好、你的工作环境，而且越用越聪明，可以自主进化。它能执行代码、操作文件、浏览网页它能记住你上次聊了什么，不用每次重新介绍自己它能定时执行任务，即使你不在电脑前它能同时出现在你的 Telegram、Discord、Slack、微信等 10+
本文详细介绍了Hermes Agent的安装、配置与实战应用。Hermes Agent是一款开源的AI Agent框架，具备跨会话持久记忆、定时任务、多平台消息接入等强大功能。文章从基础安装、模型配置、CLI及Web UI使用，到核心功能详解、高级配置和实战场景，全面覆盖了Hermes Agent的应用。此外，还解答了常见问题，并提供了进阶技巧，帮助读者深入理解和掌握这一全能型AI Agent。
一份面向所有人的 Hermes Agent 安装、配置与实战教程。无论你是开发者、研究者还是普通用户，都能从这里开始你的 AI Agent 之旅。
什么是 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 模型提供商。你不需要锁定某一家，随时可以切换。
推荐的模型配置
🔥 日常使用 → Claude Sonnet（Anthropic）— 性价比最高💻 编程任务 → Claude Opus（Anthropic）— 最强编程能力⚡ 快速问答 → GPT-4o-mini（OpenAI）— 便宜快速🇨🇳 中文优化 → DeepSeek Chat（DeepSeek）— 中文效果好，价格低🏠 本地运行 → Llama 3（Ollama）— 完全免费，隐私保护
配置方式
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
假如你从2026年开始学大模型，按这个步骤走准能稳步进阶。
接下来告诉你一条最快的邪修路线，
3个月即可成为模型大师，薪资直接起飞。
阶段1:大模型基础
阶段2:RAG应用开发工程
阶段3:大模型Agent应用架构
阶段4:大模型微调与私有化部署
配套文档资源+全套AI 大模型 学习资料，朋友们如果需要可以微信扫描下方二维码免费领取【保证100%免费】👇👇
配套文档资源+全套AI 大模型 学习资料，朋友们如果需要可以微信扫描下方二维码免费领取【保证100%免费】👇👇
Agent 垂直技术社区，欢迎活跃、内容共建。
更多推荐
9
0- 0
已为社区贡献129条内容
所有评论(0)