企业官网建设流程全解析

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 的配置分散在几个位置，各管一摊：

第一步是准备密钥文件，里面每个提供商都有注释说明：

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 定制版就会成形。