夜雨聆风一份面向所有人的 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-agentcd ~/.hermes/hermes-agent# 2. 创建虚拟环境并安装依赖python3 -m venv venvsource venv/bin/activatepip 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：
# AnthropicANTHROPIC_API_KEY=sk-ant-xxxxx# OpenAI OPENAI_API_KEY=sk-xxxxx# DeepSeekDEEPSEEK_API_KEY=sk-xxxxx
第三部分：基础使用
终端交互（CLI）
常用斜杠命令
在交互式聊天中输入以下命令：
实际使用示例
示例 1：代码开发
你：帮我写一个 FastAPI 的用户认证系统，支持 JWTHermes：（自动创建项目文件、安装依赖、写代码、运行测试）
示例 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 status2. 技能系统（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 KeysANTHROPIC_API_KEY=sk-ant-xxxxxOPENAI_API_KEY=sk-xxxxxDEEPSEEK_API_KEY=sk-xxxxxGOOGLE_API_KEY=xxxxx# Web UIHERMES_WEBUI_PORT=8787HERMES_WEBUI_PASSWORD=your-passwordHERMES_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 和 PR4. 生成一份简报发送到我的 Telegram"
场景 3：代码审查助手
你：审查这个 PR 的代码质量 https://github.com/user/repo/pull/123Hermes：（自动拉取 PR 代码、分析变更、检查安全问题、给出建议）
场景 4：数据分析管道
你：每天凌晨 2 点自动运行数据分析脚本 脚本路径：/home/user/scripts/analyze.py 如果发现异常数据，发邮件通知 admin@example.comHermes：（创建 cron 任务，设置邮件通知）
场景 5：多平台同步
# 配置 Telegramhermes 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
结语
Hermes Agent 代表了 AI Agent 发展的一个重要方向——从简单的问答工具，进化为真正能理解和记住用户的智能伙伴。
它不仅仅是一个工具，更是一个会成长的数字助手。随着使用时间的增加，它会越来越了解你的工作习惯、偏好和需求，成为一个真正有用的 AI 同事。
开始你的 Hermes 之旅：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash资源与社区
官方文档：https://hermes-agent.nousresearch.com/docs/
GitHub 仓库：https://github.com/NousResearch/hermes-agent
Web UI：https://github.com/nesquena/hermes-webui
技能市场：
hermes skills browse社区技能合集：
hermes skills search
进化的实验室 — 专注 AI 、技术与认知进化
关注我们，获取更多 AI 工具使用技巧和深度分析
