Hermes Agent 配置与定制完全指南：5 步装好你的 AI 代理
刚装好的 AI 代理不好用：对话不记上下文，开发项目里又总想执行高危命令，每轮响应还慢、还贵。根源往往不在模型，而在配置。Hermes Agent 是一个会自我进化的开源 AI 代理，能从经验里沉淀技能、跨会话记住你的偏好。下面从装好跑通讲到按场景定制。
🚀 跑起来：安装与第一次运行
这一节解决新手最常见的问题：让 Hermes Agent 第一次在自己机器上给出回应。重点不是背步骤，而是"跑通"。
把仓库克隆到本地目录，执行安装脚本，依赖环境由脚本自己搞定：
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent cd hermes-agent ./setup-hermes.sh # 安装脚本，完成环境配置接着跑一遍首次向导，一次性选定模型和工具，再用体检命令确认环境没缺东西：
hermes setup # 首次向导，选模型、开工具 hermes doctor # 体检：依赖、配置、常见问题 hermes # 进入对话如果只是想快速用起来，可以先跳过hermes doctor，遇到问题再回来查。Windows 上可以直接在 PowerShell 里走安装流程，装完的体验一致。
🗺️ 配置地图：Hermes Agent 的配置都藏在哪
定制之前先知道东西在哪，免得改来改去找不到地方。这一节用"文件 + 目录"的方式画一张配置地图。
Hermes Agent 的配置分散在几个位置，各管一摊：
| 位置 | 管什么 |
|---|---|
.env.example/.env | API 密钥等密钥，拷贝模板后填写 |
~/.hermes/config.yaml | 主配置：默认模型、工具权限、会话策略、技能开关 |
skills/ | 内置技能模块，按类别组织（github、mlops 等） |
~/.hermes/skills/ | 你自己安装或创建的用户技能 |
environments/ | 各运行环境的配置，各自带执行策略与安全限制 |
AGENTS.md | 工作区说明，告诉代理项目背景与约定 |
第一步是准备密钥文件，里面每个提供商都有注释说明：
cp .env.example .env打开.env，把你要用的提供商那一段取消注释并填上密钥即可。起步只需要填一个，后面随时可以加。
注意：.env只放密钥；超时、日志级别、默认模型这类普通设置一律进config.yaml，别混在一起。
🎯 按场景定制：同一个 Agent 的两种玩法
配置不是"越多越好"，而是按用途取舍。下面两种典型场景，你挑一个离自己近的照着动。
日常对话助手
目标是：响应快、语气顺、风险低。
- 选一个快速便宜的模型：用
hermes model切换，或在config.yaml里改model.default。 - 收小工具面：
hermes tools关掉终端、文件写入这类工具，纯聊天用不上 shell。 - 会话管理：对话历史的存储与清理策略在
config.yaml里调；对话中随时/new开新会话。 - 人格：
/personality切换语气，给办公助手换种口吻。
桌面版按来源文件夹归整会话，能一眼分辨哪些对话来自哪里：
开发任务搭档
目标是：能真干活，还不会搞坏你的机器。
- 打开终端与代码工具，把工作目录指到项目上（
terminal.cwd）。 - 给终端执行选一个隔离后端（Docker、SSH 等），高危命令不直接碰宿主机。
- 在仓库根目录放好
AGENTS.md，代理每轮都会参考它理解项目约定。 - 长任务临时换强模型，平时仍走便宜模型，不必为每句闲聊付顶配价格。
hermes tools # 查看已启用哪些工具 hermes config set terminal.cwd ~/code/my-project hermes config get model.default # 确认当前默认模型⚙️ 进阶：扩展工具、技能与性能调优
基础配置完成后，这一章回答两个诉求：能力更多一点，成本更低一点。
扩展自定义工具。别急着改核心代码。Hermes Agent 的惯例是"CLI 命令 + 技能"：在skills/下建一个技能目录，用SKILL.md描述工具做什么，就能以斜杠命令调用。内置技能在skills/，更重的细分技能放在optional-skills/，按需安装：
hermes skills install official/github/codebase-inspection技能注册与维护。代理自己创建的技能落在~/.hermes/skills/，使用次数记录在.usage.json里；长期没被用到的技能会被自动归档，随时可以恢复。
提示缓存。长对话的前缀会被缓存并在每轮复用；对话中途换工具集或重建系统提示会让缓存失效，费用立刻上去。所以模型、工具的调整都放在新会话之前做；对话太长时用/compress压缩上下文。
资源使用控制。Hermes Agent 跑在一台每月几美元的小 VPS 或容器里没问题。部署时可以用容器参数限定内存与 CPU，别把整台机器都交给它。
🧯 避坑速查：新手最常踩的 3 个坑
- 现象：装完提示找不到
hermes命令原因：安装脚本改过 shell 配置，当前终端还没重新加载。 解决：执行source ~/.bashrc，或者直接开一个新终端。 - 现象：在
.env里写LLM_MODEL不生效原因：模型现在从config.yaml读取，.env里那行仅作参考保留。 解决：用hermes model选择，或hermes config set model.default ...。 - 现象：长对话费用突增、首字变慢原因：对话中途改动配置或工具，提示缓存被作废。 解决：调整放在新会话前进行；跑长任务时穿插
/compress回收空间。
下一步去哪
仓库里继续深入：README.zh-CN.md有完整命令表，AGENTS.md讲架构与扩展思路，skills/和tests/里有可对照学习的示例与用例。挑一个场景先跑起来，跑通一次，再调一处配置，你的 Hermes Agent 定制版就会成形。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考