接入 Hermes

Hermes 是 Nous Research 打造的开源自我进化 AI Agent，也是目前开源生态中少数具备完整学习闭环的Agent框架。它的核心优势在于内置了从经验到技能的完整沉淀机制：能够从每一次交互、任务执行结果中自动生成可复用的技能，在使用过程中持续优化响应逻辑、沉淀用户专属知识，并在跨会话中逐步构建符合你使用偏好的动态模型，越用越贴合你的需求，是打造个人专属工作助理、自定义业务Agent的首选方案。

接入DeepSeek模型后，Hermes可以借助DeepSeek V4的强推理能力、百万级上下文窗口、高性价比优势，大幅提升多步骤任务规划、长文档理解、复杂逻辑处理的能力，同时降低长期使用Agent的成本，尤其适合AI Agent爱好者、需要专属个人助手的职场人、想要搭建自定义业务Agent的开发者使用。

通过本教程，你将掌握Hermes的快速安装、DeepSeek模型配置的全流程操作，最终启动一个具备自我进化能力、由DeepSeek驱动的专属AI Agent。

1. 安装 Hermes

本步骤的核心目的是完成Hermes的二进制部署与环境配置，安装脚本会自动处理所有依赖，无需用户手动编译或配置复杂的环境参数。

快速安装

通过一行安装命令，你可以在两分钟内快速启动 Hermes Agent，全程无需人工干预。

Linux / macOS / WSL2

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

唯一前置依赖是 Git，其余内容安装脚本会自动处理。Git的作用是拉取Hermes的安装脚本与依赖资源，你可以通过执行git --version检查是否已安装Git，若未安装可通过系统包管理器（如apt、brew）快速安装。

国内用户注意事项：若GitHub访问速度较慢，你可以配置GitHub镜像源或使用网络代理提升安装速度，避免脚本拉取失败。

更多安装说明请参考 Hermes 安装文档。

操作验证：安装完成后终端会输出安装成功的提示，重新加载shell后执行hermes --version能正常输出版本号即为安装成功。

避坑提示：不要使用sudo执行安装脚本，否则会将Hermes安装到root用户目录下，后续普通用户无法访问。若提示权限不足，请先为当前用户授予~/.local/bin目录的读写权限。

2. 运行并配置

本步骤的核心目的是完成Hermes的基础配置，指定使用DeepSeek作为模型提供商，配置API凭据与默认模型，让Hermes可以正常调用DeepSeek的模型服务。

重新加载 shell 后，开始配置 Hermes：

• 执行 hermes setup 命令。该命令会启动Hermes的初始化配置向导，引导你完成所有基础配置项，无需手动编辑配置文件。
• 选择 Quick Setup。快速配置模式会跳过高级参数设置，仅配置必要选项，适合首次使用的用户快速搭建可用环境，进阶用户后续可以通过修改配置文件调整更多参数。
• 当提示选择模型提供商时，选择 DeepSeek。该选项会告诉Hermes调用DeepSeek的API接口，自动适配DeepSeek的请求格式与参数规范。
• 输入你的 DeepSeek API Key。API Key是DeepSeek平台验证身份与计费的凭据，请确保填写正确，妥善保管不要泄露。
• Base URL 填写 https://api.deepseek.com。该地址是DeepSeek官方API的服务端点，无需修改，除非你使用自定义的API代理服务。
• 选择 deepseek-v4-pro 模型。该模型的推理能力最强，最适配Hermes的自我进化、多步骤规划需求，若你更看重成本与响应速度，后续也可以切换为deepseek-v4-flash模型。
• 继续完成其余配置选项。后续配置项包括Agent名称、记忆保留时长、技能生成规则等，你可以根据自身需求选择，也可以直接按回车使用默认值。

操作验证：配置完成后终端会提示配置已保存，执行hermes run启动Agent对话，发送测试消息能正常收到回复即为配置成功。

最佳实践

1. 新手配置建议：首次使用建议完全使用默认配置，待熟悉功能后再逐步调整参数，避免配置错误导致无法使用。
2. 场景化调整：日常简单查询场景可以将默认模型切换为deepseek-v4-flash，降低使用成本；处理复杂任务时再切换回deepseek-v4-pro。
3. 技能管理：Hermes生成的技能会自动存储在本地，你可以通过hermes skill list命令查看已生成的技能，也可以手动编辑、删除不需要的技能。

常见问题

1. 执行hermes提示命令不存在：检查是否重新加载了shell，或者手动将~/.local/bin目录添加到PATH环境变量中，执行source ~/.bashrc（或对应shell的配置文件）即可生效。
2. 配置后调用Agent提示API错误：检查API Key是否正确，Base URL是否填写为https://api.deepseek.com（不要添加/v1后缀），确认DeepSeek开放平台账户余额充足。
3. Hermes无法生成技能：确认当前使用的是deepseek-v4-pro模型，低版本模型或Flash模型的推理能力不足以支撑技能生成的复杂逻辑。

后续建议

配置完成后你可以开始与Hermes交互，每次完成任务后Hermes都会自动沉淀相关技能，持续进化。你也可以参考官方文档或资源库，探索更多进阶玩法如自定义技能、多Agent协作、第三方工具集成等。

参考资料

• awesome-deepseek-agent