01 — Hermes Agent 从入门到精通

测试团队专属版

基于 官方文档 + 实战经验提炼
面向 Windows 环境 + 财政系统测试场景

作者：浅木·先生
版本：v1.0（2026-05-29）
适用版本：Hermes Agent v0.12.0 ~ v0.13.0

目录

一、Hermes 是什么

Hermes Agent 是由 Nous Research 开源的 AI Agent 框架（MIT 协议），定位是"住在你终端里的智能体"。

和 Claude Code / OpenClaw 的核心区别：

对比维度 Hermes Agent Claude Code OpenClaw
核心定位 全栈 Agent（自我进化） 编程 Agent 多智能体操作系统
持久记忆 ✅ 原生跨会话 ⚠️ 部分支持 ✅
自动创建技能 ✅ 从成功任务自动生成 ❌ ❌（手动或社区市场）
定时任务 ✅ 原生支持 ❌ ✅
多平台消息 ✅ 10+ 平台 ⚠️ 预览中 ✅ 15+ 平台
多个 Agent 隔离 ✅ Profile 机制 ❌ ✅
Windows 原生 ✅ v0.13+ Beta ❌ ❌
多模型 ✅ 20+ 提供商 ❌ 仅 Claude ✅

一句话：你团队想要一个"越来越懂测试业务、能自己学会写测试用例、能定时跑回归"的 AI 助手，选 Hermes。

二、安装与环境配置

Windows 原生安装（推荐）

前提：

  • Windows 10/11
  • PowerShell 5.1+（不是 cmd）
  • 能访问 GitHub

安装命令（以管理员身份打开 PowerShell）：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

安装器自动做的事情：

  • 检测 Python 3.10+（没有则下载安装）
  • 检测 Git（没有则下载安装）
  • 检测 uv（Python 包管理器）
  • 创建虚拟环境
  • 安装核心依赖

安装后路径：

  • 代码环境：%LOCALAPPDATA%\hermes\（可删，不影响配置）
  • 配置数据：%USERPROFILE%\.hermes\（重装不丢）

验证安装

# 查看版本
hermes --version

# 查看帮助
hermes --help

# 运行配置向导（首次必须）
hermes setup

配置向导走完 Quick setup 即可，后面可以手调。

常见安装问题

问题 原因 解决
安装下载卡住 网络限制 开代理或手动下载后放 %LOCALAPPDATA%\hermes\
hermes 命令找不到 Path 没刷新 关掉重开 PowerShell，或用 $env:Path 刷新
shell 报路径乱码 UTF-8 问题 $env:HERMES_DISABLE_WINDOWS_UTF8=1
编辑器设 VS Code 默认编辑器不是 VSCode $env:EDITOR = "code --wait"

三、基础配置

config.yaml 核心配置

配置文件位于 %USERPROFILE%\.hermes\config.yaml，这是 Hermes 的核心配置文件。

核心字段说明：

# 模型提供商
model:
  provider: openai          # 可选：openai / deepseek / ollama / ...
  name: deepseek-chat       # 模型名称
  base_url: ""              # API 地址（默认用提供商的标准地址）

# 工具集开关（按需启用以防系统变慢）
tools:
  # web: true               # 网页抓取
  # browser: true           # 浏览器操控
  # terminal: true          # 终端执行
  # file: true              # 文件操作

# 记忆配置
memory:
  provider: mem0            # 可选：builtin / mem0 / hindsight

# Gateways
gateways:
  enabled: true
  port: 8642                # Gateway 监听端口，Web UI 也用这个

# 安全配置
approvals:
  mode: manual              # manual = 危险操作需确认

模型配置（DeepSeek / Qwen / Ollama）

DeepSeek（推荐日常使用）：

# config.yaml
model:
  provider: deepseek
  name: deepseek-chat
  base_url: ""              # 跳过，用默认

# .env 文件（%USERPROFILE%\.hermes\.env）
DEEPSEEK_API_KEY=sk-你的key

千问（国内直连）：

model:
  provider: openai
  name: qwen-plus
  base_url: https://dashscope.aliyuncs.com/compatible-mode/v1

# .env
OPENAI_API_KEY=你的千问APIKey

模型选型建议

使用场景 推荐模型 原因
日常对话/用例生成 DeepSeek-Chat 便宜、中文好、够用
复杂逻辑推理 Claude Sonnet 思维链最强
快速简单任务 GPT-4o-mini 速度快、成本低
内网/离线环境 Qwen2.5:7B (Ollama) 免费、不联网
代码/脚本生成 Claude Opus 代码质量最佳

四、SOUL.md 与 AGENTS.md——最重要的两个文件

很多人装完 Hermes 就去装插件。顺序错了。最值得先处理的，是这两个文件。

SOUL.md：定义 Agent 的"性格"

  • 位置：%USERPROFILE%\.hermes\SOUL.md
  • 作用：全局身份、语气、协作方式
  • 适用场景：所有会话、所有项目

SOUL.md 不应该包含的内容：

  • ❌ 项目路径、端口、启动命令 → 这些放 AGENTS.md
  • ❌ API Key/Token/密码 → 放 .env
  • ❌ 空泛的"请认真工作" → 没信息量

SOUL.md 应该写的（4~8 条核心规则就够了）：

AGENTS.md：定义项目的"规矩"

  • 位置：项目根目录（放在 STDT 这种具体项目下）
  • 作用：特定项目的目录结构、命令、规则
  • 适用场景：在该目录下启动 Hermes 时自动加载

常见错误：

  • ❌ 把 SOUL.md 放到项目目录（应该放 ~/.hermes/）
  • ❌ 把项目配置写进 SOUL.md（应该放项目根目录的 AGENTS.md）

模板：测试团队 SOUL.md

# SOUL.md — 测试团队 AI 助手人格定义

## 身份定位

你是测试部门副经理的 AI 搭档，深耕政府财务/财政系统质量保障。
你务实、说人话、不堆概念。

## 沟通风格

- 先说结论再展开，能一句话说完不写两段
- 给方案时带上具体命令或配置，不写空泛的理论
- 遇到不确定的信息先核实，不编造

## 工作原则

- 安全问题必须提醒，不回避
- 遇到坑直说坑在哪，不美化
- 接手任务先确认范围和前提，不猜

## 输出规范

- 涉及财政系统时自动结合预算编制/资金支付/政府采购等业务场景
- 涉及自动化方案时优先考虑 Playwright + pytest 技术栈
- 涉及时效任务（测试报告/周报）时，主动调用工作日志模板

## 避免做的事

- 不要在我已经说清楚方案后反复确认"要不要做"
- 不要在代码/配置改完后不告诉我结果
- 不要为了显得专业而堆术语

模板：AGENTS.md

# AGENTS.md — STDT 项目工作规范

## 项目说明

财政系统测试工具集 STDT（Standard Testing Development Toolkit）。
用于财政一体化软件的质量保障，包含：
- 接口自动化脚本
- 测试用例生成与维护
- 性能测试方案
- 质量数据统计

## 目录结构

STDT/
├── docs/ → 知识库手册（由公众号文章整理）
├── output/ → 原始素材（公众号文章 + 精华总结）
├── src/ → 测试工具源码
├── venv/ → Python 虚拟环境
└── 工作日志/ → 每日工作日志


## 常用命令

- 运行测试：`pytest src/tests/ -v`
- 配置检查：`hermes doctor`
- 日志查看：`hermes logs`
- 记忆检查：`hermes memory status`

## 工作规则

- 生成的工作日志统一放到 `工作日志/` 目录
- 文档署名必须写"孔凡腾"
- 修改测试脚本后先跑一遍通过再提交

## 禁止事项

- 不要直接修改 production 级别的测试配置
- 不要在未确认的情况下修改已经绑定的测试环境配置

五、Profile 多 Agent 管理

为什么需要多 Profile

默认情况下所有任务都在同一个 Agent 里完成。这个 Agent 的 MEMORY.md 只有 2200 字符上限，会话、记忆、技能全混在一起，很快就会被日常琐事污染。

Profile 解决什么：

  • 每个 Profile 拥有 独立 的：config.yaml、.env、SOUL.md、memories/、sessions/、skills/、state.db
  • 互不干扰，真正隔离

Profile 创建与管理

# 列出所有 Profile
hermes profile list

# 创建新 Profile（继承当前配置）
hermes profile create tester --clone

# 查看 Profile 详情
hermes profile show tester

# 切换到 Profile
hermes profile use tester

# 用 -p 临时切换
hermes -p tester chat

# 删除 Profile
hermes profile delete tester

重要：创建 Profile 后，会自动生成同名命令：

# 等价于 hermes -p tester chat
tester chat

# 等价于 hermes -p tester setup
tester setup

# 等价于 hermes -p tester gateway start
tester gateway start

Profile 的完整快照备份：

hermes profile create backup --clone-all

测试团队 Profile 规划示例

Profile 名称 用途 SOUL.md 定位
default 日常助手 通用 AI 助手
tester 测试专用 专注自动化测试脚本编写
cases 用例生成 专注测试用例设计与评审
report 报告生成 专注测试报告与数据分析
offline 内网离线 Ollama 本地模型配置

这样配置后，团队成员各用各的 Profile，记忆不会相互污染，技能库也不会混在一起。

六、Gateway 与消息平台

Gateway 是 Hermes 的消息通道。启动后才能用微信/飞书/Telegram 和 Hermes 交互。

Gateway 启动与测试

# 启动 Gateway
hermes gateway run

# 查看 Gateway 状态
hermes gateway status

# 重启 Gateway
hermes gateway restart

# 设置开机自启（Windows 服务）
hermes gateway install

重要提醒：Gateway 需要开一个独立的终端窗口跑着，不要关。

微信接入

微信是目前测试团队最方便的消息入口。

# 在配置向导中选择 Weixin/Wechat 绑定
# 会弹出一个二维码链接
# Ctrl+点击链接 → 扫码 → 完成绑定

注意事项：

  • ⚠️ 微信插件每个机器人只能连接一个智能体
  • 扫码后会解绑之前绑定的设备
  • 微信发消息没响应 → 检查 Gateway 是否在运行

飞书接入

适合公司内部使用。

# 飞书配置步骤：
# 1. 飞书开放平台创建机器人
# 2. 获取 App ID / App Secret
# 3. Hermes 配置向导中选 Feishu → 填入 ID/Secret
# 4. 扫码绑定 → 粘贴会话 ID
# 5. 选择 @mentioned 模式

七、Web UI 管理面板

hermes-web-ui 是 Hermes 的 Web 管理界面，把所有功能收敛到浏览器里。

# 全局安装
npm install -g hermes-web-ui

# 启动（默认 :8648）
hermes-web-ui start

# 其他命令
hermes-web-ui stop      # 停止
hermes-web-ui restart   # 重启
hermes-web-ui status    # 查看状态

Docker 方式：

WEBUI_IMAGE=ekkoye8888/hermes-web-ui:latest docker compose up -d

Web UI 能做哪些事：

功能 说明
AI 聊天 多会话管理、历史记录
平台配置 Telegram/Discord/Slack/微信/飞书 8 个平台统一配
用量分析 Token 消耗、费用统计、模型分布
定时任务 图形化 CRON 配置
模型管理 增删改查
多个 Profile 切换管理
文件浏览器 浏览服务端文件
技能库 查看/启用/禁用
日志 实时日志、错误日志

八、记忆系统

内置记忆与容量限制

Hermes 有两个内置记忆文件：

文件 位置 容量 用途
MEMORY.md %USERPROFILE%\.hermes\memories\MEMORY.md ~2200 字符 跨会话持久事实
USER.md %USERPROFILE%\.hermes\memories\USER.md ~1375 字符 用户画像

问题：

  • 2200 字符很快就满了，后面的信息会覆盖前面的
  • 日常聊天、任务进度、配置信息混在一起，很快变成"记忆垃圾场"

外置记忆方案（Mem0 / Hindsight）

# 进入记忆配置
hermes memory setup

会列出可选方案：

方案 特点 推荐场景
Mem0 开箱即用、自动提取、免费额度充足 ⭐ 个人日常使用首选
Hindsight 强大但免费版 100MB 限制 大规模记忆场景
Holographic 支持多种后端 有特定后端需求时
RetainDB 轻量级 不想用第三方服务

Mem0 配置步骤：

  1. 注册 https://app.mem0.ai → 获取 API Key
  2. 安装依赖：pip install mem0ai
  3. 运行 hermes memory setup → 选 mem0 → 粘贴 Key
  4. 验证：hermes memory status

重要概念：Mem0 和内置 MEMORY.md 不冲突，Mem0 是增强层。

九、技能自动沉淀与复用

这是 Hermes 最强的地方——完成任务后自动生成 Skill，下次直接复用。

流程：

  1. 让 Hermes 完成一个任务（比如"帮我写一段财政支付接口的 pytest 测试"）
  2. 完成后问它：“把刚才的流程保存成 Skill 吧”
  3. 回复"是的" → 自动生成 Skill 文件
  4. 下次提相似需求 → Hermes 自动调用已生成的 Skill

验证 Skill 是否生效：

# 查看已安装的 Skill
hermes skills list

# 查看 Skill 详情
hermes skills show <skill-name>

提示：第一次完成任务后 Hermes 不会自动创建 Skill，需要你主动问它。这是一个设计上的安全机制，不是 Bug。

十、Kanban 多 Agent 协作（v0.12.0+）

Kanban 是 Hermes v0.12.0 最重磅的功能，让 AI 从"你问我答"变成"你发任务我干活"。

Kanban 能做什么：

  • 多个 Profile 并行处理任务
  • 任务可以设置依赖关系（父任务完成 → 自动推进子任务）
  • 共享工作空间
  • 实时 Dashboard
  • SQLite 持久化（重启不丢任务）

使用场景（测试团队）：

用例设计 → 脚本开发 → 执行测试 → 生成报告
   │            │           │          │
 Worker1      Worker2     Worker3    Worker4
                              ↘
                           自动串联

简单使用：

# Kanban 集成在 Hermes 内部
# 启动后会自动创建 kanban.db
# 在 Dashboard 中查看任务看板

注意：简单问答场景直接用 Hermes 聊天即可，Kanban 是为复杂、多步骤、多角色的工作流准备的。

十一、本地离线方案（Ollama）

如果测试环境在内网、不允许外网访问，可以用 Ollama + Hermes 实现完全离线。

安装 Ollama：

# Windows：官网下载 exe 安装
# Linux/macOS：
curl -fsSL https://ollama.com/install.sh | sh

拉取模型：

# 8GB 内存选 7B 模型
ollama pull qwen2.5:7b

# 16GB+ 内存选 14B 模型
ollama pull qwen2.5:14b

配置 Hermes 连 Ollama：

# config.yaml
model:
  provider: ollama
  name: qwen2.5:7b
  base_url: http://localhost:11434

启动顺序：

  1. ollama serve → 先启动 Ollama 服务
  2. hermes start → 再启动 Hermes

性能参考：

  • 纯 CPU 跑 7B 模型约 5-10 token/s（够用但不快）
  • 有 GPU 会快很多
  • 7B 模型逻辑推理能力比商业模型（DeepSeek/Claude）有明显差距
  • 适合简单任务、信息检索、日常对话

混合模式（推荐测试团队用）：

简单任务（查日志、读文件、写简单脚本）→ 本地 Ollama，零成本
复杂任务（用例推理、复杂逻辑校验）    → 按需切云模型

十二、常用命令速查表

基础操作

命令 说明
hermes setup 首次/重新配置向导
hermes chat 启动对话
hermes --help 全部命令列表
hermes doctor 系统健康检查
hermes doctor --fix 自动修复问题

模型与工具

命令 说明
hermes model 查看/切换当前模型
hermes tools 工具管理交互界面
hermes tools list 列出已启用的工具
hermes tools enable web 启用网页工具
hermes tools disable browser 禁用浏览器工具

Profile 管理

命令 说明
hermes profile list 列出所有 Profile
hermes profile create xxx 创建新 Profile
hermes profile create xxx --clone 克隆当前配置创建
hermes profile delete xxx 删除 Profile
hermes profile use xxx 切换到 Profile

Gateway

命令 说明
hermes gateway run 启动 Gateway
hermes gateway status 查看状态
hermes gateway restart 重启
hermes gateway install 安装为系统服务
hermes gateway setup 重新配置 Gateway

记忆与日志

命令 说明
hermes memory setup 配置记忆系统
hermes memory status 查看记忆状态
hermes logs 查看日志
hermes logs errors 只看错误日志
hermes status 系统状态概览

技能与更新

命令 说明
hermes skills list 列出已安装技能
hermes skills install xxx 安装技能
hermes update 更新 Hermes 到最新版
hermes skills show xxx 查看技能详情

十三、故障排查

最常见问题速查

现象 可能原因 解决
hermes 命令找不到 未加入 Path 重启终端或手动加 Path
微信没响应 Gateway 没启动 新窗口跑 hermes gateway run
模型 401 错误 API Key 不对 检查 .env 中的 Key
模型请求超时 Base URL 不对或网络不通 检查 config.yaml 的 base_url
配置改完不生效 没重启 hermes gateway restart
记忆还是乱 容量超了 配置 Mem0 做增强层
Web UI 打不开 端口冲突或没启动 检查 :8648 端口，hermes-web-ui start
对话突然变慢 上下文太长 用 hermes chat --session new 新会话

诊断三步走

Step 1: hermes doctor          → 自动检查大部分问题
Step 2: hermes status          → 查看系统概览
Step 3: hermes logs errors     → 只看错误日志

如果以上都没用：

  • 不要一上来就重装
  • 先用 hermes doctor 定位问题
  • 遇到不确定的命令时，优先用 hermes <command> --help

附录：测试团队 Agent 搭建路线图

Day 1-2:  装好 Hermes + 跑通 chat
Day 3-4:  写好 SOUL.md + AGENTS.md → 让 Agent 懂你
Day 5:    配好模型 → DeepSeek 日常 + Ollama 内网
Day 6-7:  Profile 规划 → default 日常 / tester 测试专用
Week 2:   Gateway + 微信 → 手机也能遥控 Agent
Week 3:   接入 Web UI → 团队统一管理
Week 4:   配置 Mem0 → Agent 真正"记住"项目知识
Month 2:  Kanban → 测试流水线自动运转

建议与 INDEX.md 配合使用，按"① 先看 01 → ② 再深入 02/03/04"的顺序学习

Logo
AI Agent技术社区

Agent 垂直技术社区，欢迎活跃、内容共建。

更多推荐

cover

【花雕动手做】行空板 K10 系列实验之人工智能调用语音合成（TTS）模块

avatar AI Agent技术社区
cover

苏州企业AI Agent智能体从概念到落地：2026年开发者必须关注的技术范式与工程实践

avatar AI Agent技术社区
cover

GitHub 狂揽 4万+ Star！这个项目直接让你省下 60–95% 的 Token

avatar AI Agent技术社区