✦ Study Notes

Hermes Agent 学习笔记

零基础也能玩转 — 从安装部署到高级应用
基于B站全14集教程整理

📺 原视频:B站 BV13YRjBTEPb
📚 共 14 集
⏱️ 总时长 ~180 分钟
🏷️ 零基础·保姆级
01

Hermes Agent 简介

⏱ 9:39
概念入门 对比分析

🤖 Hermes Agent 是什么?

Hermes Agent 是 Nous Research 开源的一款AI 智能体框架。打个比方:如果说 ChatGPT 是一个能聊天的"大脑",那 Hermes Agent 就是给这个大脑装上了手脚和工具箱——它不仅能聊天,还能操作你的电脑、写代码、管理文件、控制智能家居、定时执行任务……

它的定位和 Claude Code(Anthropic)、Codex(OpenAI)属于同一类产品,但有两个独家特色:

  • 自我进化能力:通过 Skills 系统,Hermes 能从每次解决问题的经验中学习,越用越聪明
  • 跨平台网关:同一个 AI 可以在终端、微信、QQ、飞书、Telegram、Discord 等十多个平台上使用,而且功能一致
  • 🤖 AI Agent 与 LLM 全景解读

核心能力一览

能力说明
💬 智能对话支持 20+ 模型提供商,可随时切换(OpenRouter、Anthropic、DeepSeek 等)
⌨️ 终端操作在 Linux/macOS/WSL 上执行命令、管理进程
📁 文件管理读写搜索文件、编辑代码、批量处理
🌐 联网搜索浏览器自动化、网页内容抓取
🧩 技能系统可复用的工作流程,像"AI的肌肉记忆"
🧠 持久记忆跨会话记住你的偏好、环境配置、经验教训
📱 多平台终端 + Telegram/Discord/微信/QQ/飞书/Slack 等 15+ 平台
⏰ 定时任务Cron 风格的计划任务,自动执行
🔌 MCP 扩展通过 MCP 协议接入任意第三方工具
🎯 多 Agent 协作可同时运行多个 Hermes 实例,分工合作
💡 一句话总结

Hermes Agent = AI 大脑 + 操作系统权限 + 持久记忆 + 跨平台通信 + 自我进化。它是你电脑里的"数字管家"。

02

前置准备:安装前置软件

⏱ 11:11
环境配置 工具安装

🛠 你需要准备什么

在安装 Hermes 之前,需要确保系统具备以下环境:

🐍 Python 环境

Hermes 是 Python 项目,需要 Python 3.10+

python3 --version
# 应输出 3.10.x 或更高

推荐使用 pyenv 管理多个 Python 版本

📦 Git & 系统工具

  • Git — 代码管理和 Skills 下载
  • pip / pipx — Python 包管理
  • curl / wget — 网络请求
  • Linux: build-essential 等编译工具
  • macOS: Xcode Command Line Tools
  • Windows: WSL2(推荐)
📋
Linux 一键安装依赖(Ubuntu/Debian)
sudo apt update && sudo apt install -y python3 python3-pip python3-venv git curl build-essential
⚠️
重要提示

如果使用 Windows,强烈建议在 WSL2 中运行。原生 Windows 支持有限,部分功能(如终端操作)可能无法正常工作。

03

Hermes Agent 安装与部署

⏱ 9:20
安装教程 命令行

🚀 三种安装方式

🥇
方式一:一键安装脚本(推荐新手)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

脚本会自动处理所有依赖,安装完成后运行 hermes 即可开始。

🥈
方式二:pip 安装(推荐开发者)
pip install hermes-agent
hermes setup   # 初始化配置
🥉
方式三:Git 源码安装(想贡献代码)
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
pip install -e .
hermes

⚙️ 安装后的首次配置

运行 hermes setup
选择模型提供商
配置 API Key
选择默认模型
开始使用!

配置向导会引导你完成模型选择(OpenRouter 推荐新手,免费额度够用)、API Key 设置等。完成后配置保存在 ~/.hermes/config.yaml 中。

🏥 健康检查

hermes doctor          # 检查配置和依赖
hermes doctor --fix    # 自动修复常见问题
hermes status          # 查看运行状态
04

接入应用(微信、QQ、飞书)

⏱ 17:36
Gateway 跨平台 消息平台

🌐 Gateway 网关 — 让 Hermes 无处不在

Hermes 的 Gateway(网关)是一个消息中继系统,让 Hermes 同时连接到多个聊天平台。你在微信上发消息,Hermes 就能在终端里回复——背后是同一个 AI 大脑。

📱 支持的平台

  • Telegram — Bot API
  • Discord — Bot Token
  • 微信 (WeChat) — Bridge 连接
  • QQ — 插件支持
  • 飞书 (Feishu) — 应用机器人
  • Slack — Bot Token
  • WhatsApp — API 接入
  • Signal — signal-cli
  • 钉钉 (DingTalk) — 机器人
  • Email / SMS — 邮件短信

🔧 配置步骤(以微信为例)

安装微信插件
配置 Bridge
启动 Gateway
微信扫码连接
# 配置网关平台
hermes gateway setup

# 启动网关服务
hermes gateway run        # 前台运行(调试用)
hermes gateway start      # 后台服务(生产用)

# 查看状态
hermes gateway status
💡 核心理解

Gateway 就像给 Hermes 装了一个"万能聊天适配器"。不管消息从哪个平台进来,都走同一套 AI 逻辑处理。你可以在终端里说话,别人在微信上回复——无缝衔接。

05

第一个应用案例

⏱ 8:50
动手实践 Hello World

🎯 三个入门级实战

安装完 Hermes 后,可以从这些简单任务开始体验:

📝 案例一:写一份项目 README

对着 Hermes 说:"帮我给当前项目写一份专业的 README.md"

Hermes 会自动扫描项目文件,理解项目结构,生成一份结构完整的 README。

🔍 案例二:代码审查

对着 Hermes 说:"审查 app.py 的代码,找出潜在的安全问题和性能瓶颈"

Hermes 会读文件、分析逻辑、给出详细的审查报告。

📊 案例三:数据分析

对着 Hermes 说:"分析 data.csv,画出销售趋势图,写一份分析报告"

Hermes 会:读文件 → 用 Python 做分析 → 用 matplotlib 画图 → 生成 Markdown 报告,全程自动化。

✨ 关键体验

第一次使用时你会惊讶:它不是简单的问答机器人。你说"帮我做X",它真的会自动调用工具、执行命令、读取文件、生成结果——像一个真正的助手在操作你的电脑。

06

个性化定制

⏱ 11:35
配置 人格

🎭 让 Hermes 做自己 — 四种定制维度

👤 人格设置

Hermes 有一个叫 Persona(人格) 的配置,定义了它的"性格"——你是想让 Hermes 像一个严谨的工程师,还是一个幽默的朋友?

# 在会话中切换人格
/personality [name]

# 查看可用人格
hermes personality list

人格文件是纯文本 Markdown,你可以完全自定义!

🧠 推理深度

可以控制 Hermes 的"思考时间":

/reasoning [level]
# none | minimal | low |
# medium | high | xhigh

推理越深,回答质量越高,但也消耗更多 token(成本更高)。日常聊天用 low,复杂编程用 high。

👥 Profiles — 多身份切换

Profiles 让你在一台机器上拥有多个独立的 Hermes——每个 Profile 有自己的配置、记忆、技能、会话历史。就像电脑的"多用户"功能。

hermes profile create work       # 工作专用
hermes profile create personal   # 个人专用
hermes -p work                   # 以工作身份启动
hermes -p personal               # 以个人身份启动

⚙️ 配置文件完全掌控

hermes config edit              # 在编辑器中打开完整配置
hermes config set KEY VALUE     # 命令行修改单项
hermes model                    # 交互式切换模型

所有配置在 ~/.hermes/config.yaml 中,透明、可编辑、可备份。

07

工具与工具集

⏱ 8:55
Tools 插件系统

🔧 工具 — Hermes 的"手脚"

工具是 Hermes 与外部世界交互的方式。就像人类用"手"抓东西、用"脚"走路,Hermes 用"工具"来操作文件、执行命令、搜索网络。

📦 内置工具集一览

工具集提供的能力默认状态
terminal执行 Shell 命令、进程管理✅ 开启
file读写搜索文件、代码编辑✅ 开启
web网络搜索、网页内容获取✅ 开启
browser浏览器自动化操作可选
vision图片分析和理解✅ 开启
image_genAI 图片生成可选
tts文字转语音可选
memory跨会话持久记忆✅ 开启
delegation派生子 Agent 并行任务✅ 开启
cronjob定时任务调度✅ 开启
session_search搜索历史会话✅ 开启

🎮 管理工具

hermes tools                  # 交互式界面管理(推荐)
hermes tools list             # 查看所有工具状态
hermes tools enable browser   # 启用浏览器工具
hermes tools disable web      # 禁用网络工具

省钱技巧: 如果不需要网络搜索,关掉 webbrowser 工具集可以显著减少每次对话的 token 消耗。

08

Skills — 机器的肌肉记忆

⏱ 17:08
核心特性 进阶

🧩 Skill 是什么?为什么它是杀手级特性?

Skills = 可复用的操作手册。 当 Hermes 成功完成一个复杂任务后,可以把整个工作流程保存为一个 Skill。下次遇到同类任务,直接加载这个 Skill,就像考试带了一份标准答案。

举个例子:你教会了 Hermes 如何部署一个 Docker 容器(需要 10+ 步操作)。把这个流程存为 Skill,以后说"部署容器",Hermes 直接按手册操作,一步不差。

📚 Skill 市场 & 管理

hermes skills browse          # 浏览 Skills 市场
hermes skills search python   # 搜索 Python 相关技能
hermes skills install ID      # 安装技能
hermes skills list            # 已安装的技能

# 在会话中加载技能
/skill hermes-agent

Skills 市场有社区贡献的数百个技能——从 GitHub PR 工作流到数据分析管道,从游戏服务器部署到机器学习模型训练。

🧠 深层理解

Skills 让 Hermes 实现了"越用越聪明"的正循环。每次解决问题的经验不是用完就丢——它们被沉淀为可复用的知识,Agent 的能力随使用时间增长。这就是 Hermes 和普通 AI 助手的本质区别。

09

持久记忆 — 让 AI 真正认识你

⏱ 15:33
Memory 核心特性

🧠 两种记忆模式

Hermes 有两层记忆系统,就像人类的"短期记忆"和"长期记忆":

📝 短期记忆

会话历史搜索 — 能搜索你之前的所有聊天记录

比如:"上次我们讨论的那个 bug 是怎么修的?" Hermes 会搜索历史会话找到答案。

💾 长期记忆

持久化关键信息 — 跨会话记住你是谁

你的名字、编程风格偏好、项目结构、常用工具……每次对话都自动带入。

🔌 记忆后端可插拔

后端特点
内置(默认)零配置,SQLite 存储,开箱即用
Honcho专业的 AI 记忆管理服务
Mem0云端记忆服务,多设备同步
hermes memory setup     # 配置记忆后端
hermes memory status    # 查看记忆状态
💡 实用场景

你告诉 Hermes "我喜欢简洁的回答,少用术语"。一星期后你再问问题,它还记得。这就是持久记忆的价值——不用每次都重新解释。

10

皮肤与主题

⏱ 11:02
美化 终端UI

🎨 让你的终端更好看

Hermes 的 CLI 界面支持多种主题皮肤,从极简到赛博朋克风格都有。在会话中随时切换:

/skin [name]           # 切换皮肤
/skin list             # 查看所有可用皮肤

皮肤不仅改变颜色,还能调整布局风格——工具调用是否显示、思考过程是否展开、状态栏样式等。

🎛 显示选项

hermes config set display.skin dracula    # 设置默认皮肤
hermes config set display.show_reasoning true   # 显示推理过程
hermes config set display.show_cost true         # 显示每次调用的花费
hermes config set display.tool_progress true     # 显示工具执行进度

不同的皮肤适合不同的场景——写代码用简洁主题,演示用炫酷主题。

11

MCP 扩展 AI 工具能力

⏱ 13:08
高级 协议

🔌 什么是 MCP?

MCP(Model Context Protocol) 是 Anthropic 推出的开放协议,让 AI 模型能安全地访问外部工具和数据源。你可以把它理解为"AI 工具的 USB-C 接口"——统一标准,即插即用。

🎯 为什么需要 MCP?

Hermes 内置的工具虽然强大,但总有覆盖不到的场景。MCP 让你可以接入任何第三方工具——数据库管理工具、项目管理平台、自定义 API……只要对方支持 MCP 协议,Hermes 就能用。

hermes mcp add my-tool --url http://localhost:3000
hermes mcp list               # 查看已连接的 MCP 服务
hermes mcp test my-tool       # 测试连接
hermes mcp remove my-tool     # 断开连接
🌍 生态

MCP 生态正在快速发展。社区已经有数百个 MCP 服务器——连接 Notion、Airtable、PostgreSQL、GitHub 等。这意味着 Hermes 的能力边界几乎无限

12

定时任务 (Cron)

⏱ 17:53
自动化 调度

让 AI 定时为你工作

Hermes 内置了一个 Cron 调度器。你可以设置定时任务,让 Hermes 在指定时间自动执行——不需要你在线,不需要手动触发。

📋 实用场景

  • 每天早上 8 点:抓取你关注的博客更新,生成摘要发到微信
  • 每小时:检查服务器健康状态,异常时自动报警
  • 每周五:整理 GitHub 项目进展,生成周报
  • 收盘后:抓取股票数据,分析趋势

⌨️ 命令速查

hermes cron create "0 9 * * *"   # 每天早上9点
hermes cron create "every 2h"     # 每2小时
hermes cron create "30m"          # 30分钟后执行一次
hermes cron list                  # 查看所有定时任务
hermes cron pause my-job          # 暂停任务
hermes cron resume my-job         # 恢复任务
hermes cron remove my-job         # 删除任务
💡
定时任务的输出自动送达

如果配置了 Gateway,定时任务的执行结果会自动发送到你的微信/Telegram/Discord。你不需要主动查看。

13

Web 仪表板

⏱ 6:32
Web UI 可视化

🖥 不只是终端 — Hermes 也有 Web 界面

虽然 Hermes 以终端界面著称,但它也提供了 Web 仪表板,适合不习惯命令行的用户、或者需要可视化管理的场景。

📊 仪表板能做什么?

  • 会话管理:浏览、搜索、导出历史会话
  • 使用统计:Token 消耗、花费分析、使用趋势图
  • Skills 管理:浏览、安装、启停技能
  • Cron 任务可视化:查看、创建、管理定时任务
  • Gateway 状态:查看各平台连接状态
  • 配置管理:图形化编辑配置文件
hermes insights --days 30    # 查看30天使用统计
hermes sessions browse       # 交互式浏览会话
14

最佳实践

⏱ 14:07
技巧 总结

🏆 10 条最佳实践

  1. 从简单任务开始 — 先用 Hermes 做文件操作、信息查询等简单任务,建立信任后再让它操作关键系统。
  2. 善用 Skills — 完成复杂任务后立刻存为 Skill。这是 Hermes 增值最快的方式。
  3. 开启持久记忆 — 让 Hermes 记住你的偏好、项目结构、常用工具,长期下来体验显著提升。
  4. 合理使用推理深度 — 闲聊用 /reasoning low,写代码用 /reasoning high,省钱又高效。
  5. 配置 Profiles — 工作和个人分开,避免记忆和配置混乱。
  6. 善用定时任务 — 把重复性工作交给 Cron,让 AI 替你跑腿。
  7. 工具集按需开启 — 不需要的工具关掉,减少 token 消耗和响应时间。
  8. 学习斜杠命令/new 开新会话、/compress 压缩上下文、/undo 撤销,这些命令能大幅提升操作效率。
  9. 及时更新hermes update 保持最新版本,新功能和修复不断推出。
  10. 加入社区 — Hermes 开源且活跃,遇到问题去 GitHub Issues 或社区求助,通常很快得到解答。

🔑 核心安全原则

⚠️
不要 --yolo
除非你完全信任任务,否则不要跳过命令审批。默认的 approvals.mode: manual 会在执行危险命令前让你确认。
🔐
API Key 放 .env
密钥放在 ~/.hermes/.env 中,不要写在配置文件里,更不要分享给他人。
🌟 学习路径总结

第1-3集打基础 → 第4-5集上手实操 → 第6-7集个性化配置 → 第8-9集核心特性(Skills + 记忆)→ 第10-13集高级功能 → 第14集成最佳实践。
学完这套教程,你就能把 Hermes Agent 变成真正的私人 AI 管家