01 — Hermes Agent 从入门到精通测试团队专属版基于 官方文档 实战经验提炼面向 Windows 环境 财政系统测试场景作者浅木·先生版本v1.02026-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 管理为什么需要多 ProfileProfile 创建与管理测试团队 Profile 规划示例六、Gateway 与消息平台Gateway 启动与测试微信接入飞书接入七、Web UI 管理面板八、记忆系统内置记忆与容量限制外置记忆方案Mem0 / Hindsight九、技能自动沉淀与复用十、Kanban 多 Agent 协作十一、本地离线方案Ollama十二、常用命令速查表十三、故障排查一、Hermes 是什么Hermes Agent 是由 Nous Research 开源的 AI Agent 框架MIT 协议定位是住在你终端里的智能体。和 Claude Code / OpenClaw 的核心区别对比维度Hermes AgentClaude CodeOpenClaw核心定位全栈 Agent自我进化编程 Agent多智能体操作系统持久记忆✅ 原生跨会话⚠️ 部分支持✅自动创建技能✅ 从成功任务自动生成❌❌手动或社区市场定时任务✅ 原生支持❌✅多平台消息✅ 10 平台⚠️ 预览中✅ 15 平台多个 Agent 隔离✅ Profile 机制❌✅Windows 原生✅ v0.13 Beta❌❌多模型✅ 20 提供商❌ 仅 Claude✅一句话你团队想要一个越来越懂测试业务、能自己学会写测试用例、能定时跑回归的 AI 助手选 Hermes。二、安装与环境配置Windows 原生安装推荐前提Windows 10/11PowerShell 5.1不是 cmd能访问 GitHub安装命令以管理员身份打开 PowerShellirmhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex安装器自动做的事情检测 Python 3.10没有则下载安装检测 Git没有则下载安装检测 uvPython 包管理器创建虚拟环境安装核心依赖安装后路径代码环境%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_UTF81编辑器设 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# Gatewaysgateways:enabled:trueport:8642# Gateway 监听端口Web UI 也用这个# 安全配置approvals:mode:manual# manual 危险操作需确认模型配置DeepSeek / Qwen / OllamaDeepSeek推荐日常使用# config.yamlmodel:provider:deepseekname:deepseek-chatbase_url:# 跳过用默认# .env 文件%USERPROFILE%\.hermes\.envDEEPSEEK_API_KEYsk-你的key千问国内直连model:provider:openainame:qwen-plusbase_url:https://dashscope.aliyuncs.com/compatible-mode/v1# .envOPENAI_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 项目工作规范 ## 项目说明 财政系统测试工具集 STDTStandard 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 startProfile 的完整快照备份hermes profile create backup --clone-all测试团队 Profile 规划示例Profile 名称用途SOUL.md 定位default日常助手通用 AI 助手tester测试专用专注自动化测试脚本编写cases用例生成专注测试用例设计与评审report报告生成专注测试报告与数据分析offline内网离线Ollama 本地模型配置这样配置后团队成员各用各的 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# 启动默认 :8648hermes-web-ui start# 其他命令hermes-web-ui stop# 停止hermes-web-ui restart# 重启hermes-web-ui status# 查看状态Docker 方式WEBUI_IMAGEekkoye8888/hermes-web-ui:latestdockercompose up-dWeb 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 配置步骤注册 https://app.mem0.ai → 获取 API Key安装依赖pip install mem0ai运行hermes memory setup→ 选 mem0 → 粘贴 Key验证hermes memory status重要概念Mem0 和内置 MEMORY.md不冲突Mem0 是增强层。九、技能自动沉淀与复用这是 Hermes 最强的地方——完成任务后自动生成 Skill下次直接复用。流程让 Hermes 完成一个任务比如帮我写一段财政支付接口的 pytest 测试完成后问它“把刚才的流程保存成 Skill 吧”回复是的 → 自动生成 Skill 文件下次提相似需求 → Hermes 自动调用已生成的 Skill验证 Skill 是否生效# 查看已安装的 Skillhermes skills list# 查看 Skill 详情hermes skills showskill-name提示第一次完成任务后 Hermes 不会自动创建 Skill需要你主动问它。这是一个设计上的安全机制不是 Bug。十、Kanban 多 Agent 协作v0.12.0Kanban 是 Hermes v0.12.0 最重磅的功能让 AI 从你问我答变成你发任务我干活。Kanban 能做什么多个 Profile 并行处理任务任务可以设置依赖关系父任务完成 → 自动推进子任务共享工作空间实时 DashboardSQLite 持久化重启不丢任务使用场景测试团队用例设计 → 脚本开发 → 执行测试 → 生成报告 │ │ │ │ Worker1 Worker2 Worker3 Worker4 ↘ 自动串联简单使用# Kanban 集成在 Hermes 内部# 启动后会自动创建 kanban.db# 在 Dashboard 中查看任务看板注意简单问答场景直接用 Hermes 聊天即可Kanban 是为复杂、多步骤、多角色的工作流准备的。十一、本地离线方案Ollama如果测试环境在内网、不允许外网访问可以用 Ollama Hermes 实现完全离线。安装 Ollama# Windows官网下载 exe 安装# Linux/macOScurl-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启动顺序ollama serve→ 先启动 Ollama 服务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列出所有 Profilehermes profile create xxx创建新 Profilehermes profile create xxx --clone克隆当前配置创建hermes profile delete xxx删除 Profilehermes profile use xxx切换到 ProfileGateway命令说明hermes gateway run启动 Gatewayhermes 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的顺序学习
01 — Hermes Agent 从入门到精通
发布时间：2026/6/6 10:37:23
01 — Hermes Agent 从入门到精通测试团队专属版基于 官方文档 实战经验提炼面向 Windows 环境 财政系统测试场景作者浅木·先生版本v1.02026-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 管理为什么需要多 ProfileProfile 创建与管理测试团队 Profile 规划示例六、Gateway 与消息平台Gateway 启动与测试微信接入飞书接入七、Web UI 管理面板八、记忆系统内置记忆与容量限制外置记忆方案Mem0 / Hindsight九、技能自动沉淀与复用十、Kanban 多 Agent 协作十一、本地离线方案Ollama十二、常用命令速查表十三、故障排查一、Hermes 是什么Hermes Agent 是由 Nous Research 开源的 AI Agent 框架MIT 协议定位是住在你终端里的智能体。和 Claude Code / OpenClaw 的核心区别对比维度Hermes AgentClaude CodeOpenClaw核心定位全栈 Agent自我进化编程 Agent多智能体操作系统持久记忆✅ 原生跨会话⚠️ 部分支持✅自动创建技能✅ 从成功任务自动生成❌❌手动或社区市场定时任务✅ 原生支持❌✅多平台消息✅ 10 平台⚠️ 预览中✅ 15 平台多个 Agent 隔离✅ Profile 机制❌✅Windows 原生✅ v0.13 Beta❌❌多模型✅ 20 提供商❌ 仅 Claude✅一句话你团队想要一个越来越懂测试业务、能自己学会写测试用例、能定时跑回归的 AI 助手选 Hermes。二、安装与环境配置Windows 原生安装推荐前提Windows 10/11PowerShell 5.1不是 cmd能访问 GitHub安装命令以管理员身份打开 PowerShellirmhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1|iex安装器自动做的事情检测 Python 3.10没有则下载安装检测 Git没有则下载安装检测 uvPython 包管理器创建虚拟环境安装核心依赖安装后路径代码环境%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_UTF81编辑器设 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# Gatewaysgateways:enabled:trueport:8642# Gateway 监听端口Web UI 也用这个# 安全配置approvals:mode:manual# manual 危险操作需确认模型配置DeepSeek / Qwen / OllamaDeepSeek推荐日常使用# config.yamlmodel:provider:deepseekname:deepseek-chatbase_url:# 跳过用默认# .env 文件%USERPROFILE%\.hermes\.envDEEPSEEK_API_KEYsk-你的key千问国内直连model:provider:openainame:qwen-plusbase_url:https://dashscope.aliyuncs.com/compatible-mode/v1# .envOPENAI_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 项目工作规范 ## 项目说明 财政系统测试工具集 STDTStandard 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 startProfile 的完整快照备份hermes profile create backup --clone-all测试团队 Profile 规划示例Profile 名称用途SOUL.md 定位default日常助手通用 AI 助手tester测试专用专注自动化测试脚本编写cases用例生成专注测试用例设计与评审report报告生成专注测试报告与数据分析offline内网离线Ollama 本地模型配置这样配置后团队成员各用各的 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# 启动默认 :8648hermes-web-ui start# 其他命令hermes-web-ui stop# 停止hermes-web-ui restart# 重启hermes-web-ui status# 查看状态Docker 方式WEBUI_IMAGEekkoye8888/hermes-web-ui:latestdockercompose up-dWeb 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 配置步骤注册 https://app.mem0.ai → 获取 API Key安装依赖pip install mem0ai运行hermes memory setup→ 选 mem0 → 粘贴 Key验证hermes memory status重要概念Mem0 和内置 MEMORY.md不冲突Mem0 是增强层。九、技能自动沉淀与复用这是 Hermes 最强的地方——完成任务后自动生成 Skill下次直接复用。流程让 Hermes 完成一个任务比如帮我写一段财政支付接口的 pytest 测试完成后问它“把刚才的流程保存成 Skill 吧”回复是的 → 自动生成 Skill 文件下次提相似需求 → Hermes 自动调用已生成的 Skill验证 Skill 是否生效# 查看已安装的 Skillhermes skills list# 查看 Skill 详情hermes skills showskill-name提示第一次完成任务后 Hermes 不会自动创建 Skill需要你主动问它。这是一个设计上的安全机制不是 Bug。十、Kanban 多 Agent 协作v0.12.0Kanban 是 Hermes v0.12.0 最重磅的功能让 AI 从你问我答变成你发任务我干活。Kanban 能做什么多个 Profile 并行处理任务任务可以设置依赖关系父任务完成 → 自动推进子任务共享工作空间实时 DashboardSQLite 持久化重启不丢任务使用场景测试团队用例设计 → 脚本开发 → 执行测试 → 生成报告 │ │ │ │ Worker1 Worker2 Worker3 Worker4 ↘ 自动串联简单使用# Kanban 集成在 Hermes 内部# 启动后会自动创建 kanban.db# 在 Dashboard 中查看任务看板注意简单问答场景直接用 Hermes 聊天即可Kanban 是为复杂、多步骤、多角色的工作流准备的。十一、本地离线方案Ollama如果测试环境在内网、不允许外网访问可以用 Ollama Hermes 实现完全离线。安装 Ollama# Windows官网下载 exe 安装# Linux/macOScurl-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启动顺序ollama serve→ 先启动 Ollama 服务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列出所有 Profilehermes profile create xxx创建新 Profilehermes profile create xxx --clone克隆当前配置创建hermes profile delete xxx删除 Profilehermes profile use xxx切换到 ProfileGateway命令说明hermes gateway run启动 Gatewayhermes 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的顺序学习
