企业官网建设流程全解析

01 — Hermes Agent 从入门到精通

测试团队专属版

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

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

目录

• 一、Hermes 是什么
• 二、安装与环境配置
  • Windows 原生安装
  • 验证安装
  • 常见安装问题
• 三、基础配置
  • config.yaml 核心配置
  • 模型配置（DeepSeek / Qwen / Ollama）
  • 模型选型建议
• 四、SOUL.md 与 AGENTS.md——最重要的两个文件
  • SOUL.md：定义 Agent 的"性格"
  • AGENTS.md：定义项目的"规矩"
  • 模板：测试团队 SOUL.md
  • 模板：AGENTS.md
• 五、Profile 多 Agent 管理
  • 为什么需要多 Profile
  • Profile 创建与管理
  • 测试团队 Profile 规划示例
• 六、Gateway 与消息平台
  • Gateway 启动与测试
  • 微信接入
  • 飞书接入
• 七、Web UI 管理面板
• 八、记忆系统
  • 内置记忆与容量限制
  • 外置记忆方案（Mem0 / Hindsight）
• 九、技能自动沉淀与复用
• 十、Kanban 多 Agent 协作
• 十一、本地离线方案（Ollama）
• 十二、常用命令速查表
• 十三、故障排查

一、Hermes 是什么

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

和 Claude Code / OpenClaw 的核心区别：

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

二、安装与环境配置

Windows 原生安装（推荐）

前提：

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

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

irmhttps://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 即可，后面可以手调。

常见安装问题

三、基础配置

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# Gatewaysgateways:enabled:trueport:8642# Gateway 监听端口，Web UI 也用这个# 安全配置approvals:mode:manual# manual = 危险操作需确认

模型配置（DeepSeek / Qwen / Ollama）

DeepSeek（推荐日常使用）：

# config.yamlmodel:provider:deepseekname:deepseek-chatbase_url:""# 跳过，用默认

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

千问（国内直连）：

model:provider:openainame:qwen-plusbase_url:https://dashscope.aliyuncs.com/compatible-mode/v1

# .envOPENAI_API_KEY=你的千问APIKey

模型选型建议

四、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 创建与管理

# 列出所有 Profilehermes profile list# 创建新 Profile（继承当前配置）hermes profile create tester--clone# 查看 Profile 详情hermes profile show tester# 切换到 Profilehermes profile use tester# 用 -p 临时切换hermes-ptester chat# 删除 Profilehermes profile delete tester

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

# 等价于 hermes -p tester chattester chat# 等价于 hermes -p tester setuptester setup# 等价于 hermes -p tester gateway starttester gateway start

Profile 的完整快照备份：

hermes profile create backup --clone-all

测试团队 Profile 规划示例

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

六、Gateway 与消息平台

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

Gateway 启动与测试

# 启动 Gatewayhermes gateway run# 查看 Gateway 状态hermes gateway status# 重启 Gatewayhermes gateway restart# 设置开机自启（Windows 服务）hermes gatewayinstall

重要提醒：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 管理界面，把所有功能收敛到浏览器里。

# 全局安装npminstall-ghermes-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:latestdockercompose up-d

Web UI 能做哪些事：

八、记忆系统

内置记忆与容量限制

Hermes 有两个内置记忆文件：

问题：

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

外置记忆方案（Mem0 / Hindsight）

# 进入记忆配置hermes memory setup

会列出可选方案：

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 是否生效：

# 查看已安装的 Skillhermes 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-fsSLhttps://ollama.com/install.sh|sh

拉取模型：

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

配置 Hermes 连 Ollama：

# config.yamlmodel:provider:ollamaname:qwen2.5:7bbase_url:http://localhost:11434

启动顺序：

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

性能参考：

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

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

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

十二、常用命令速查表

基础操作

模型与工具

Profile 管理

Gateway

记忆与日志

技能与更新

十三、故障排查

最常见问题速查

诊断三步走

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"的顺序学习