Hermes Agent模型配置需统筹JVM参数、API端点、记忆持久化、多模型路由及工具调用五类参数：调整HERMES_JVM_OPTS控制内存，BaseURL/API-Key/Model name须严格匹配服务商规范，通过HERMES_STATE_DIR等变量管理记忆路径与频率，model_router.yaml定义任务路由规则，TOOL_CALL_SCHEMA=v2确保结构化工具调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在部署或运行Hermes Agent时发现模型响应迟缓、内存溢出或大模型调用失败，则很可能是核心JVM参数、模型端点配置或环境变量未正确设置。以下是针对Hermes Agent模型相关参数的详细解析与配置步骤：
一、JVM内存参数配置
Hermes Agent基于Java运行时环境构建，其稳定性与响应性能高度依赖JVM堆内存分配策略。默认配置可能无法满足多模型并行或高负载推理场景，需手动调整以避免OOM异常。
1、连接已部署Hermes Agent的ECS实例或云电脑终端。
2、编辑Hermes Agent启动环境变量文件，通常位于/etc/profile.d/hermes.sh或项目根目录下的.env文件。
3、添加或修改以下环境变量行：export HERMES_JVM_OPTS="-Xms2g -Xmx4g"。
4、保存文件后执行source /etc/profile.d/hermes.sh使配置生效。
5、重启Hermes Agent服务：sudo systemctl restart hermes或重新执行hermes命令启动交互界面。
二、大模型API端点配置
Hermes Agent通过统一抽象层对接各类大模型服务，BaseURL、API-Key与Model name三者必须严格匹配目标服务商的认证规范，否则将触发401或404错误。
1、在Hermes Agent运行环境中打开模型配置界面，如桌面应用Hermes Model或CLI中输入hermes config model。
2、选择Custom endpoint模式，进入自定义配置流程。
3、在BaseURL字段填入目标模型服务的完整地址，例如通义千问API为https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation。
4、在API-Key字段粘贴对应平台生成的有效密钥，确保无多余空格或换行符。
5、在Model name字段准确填写服务商要求的模型标识符，例如qwen-max或claude-3-5-sonnet-20241022。
三、模型会话与记忆持久化参数
Hermes Agent的跨会话记忆能力由本地SQLite数据库与文本文件协同实现，相关路径与刷新策略可通过环境变量控制，防止敏感上下文意外丢失或过度膨胀。
1、确认HERMES_STATE_DIR环境变量指向持久化目录，例如export HERMES_STATE_DIR="/opt/hermes/state"。
2、检查该目录是否存在且具备读写权限：ls -ld /opt/hermes/state与sudo chown -R hermes:hermes /opt/hermes/state。
3、设置记忆摘要频率，通过export HERMES_MEMORY_SUMMARY_INTERVAL=3600指定每3600秒自动压缩长期记忆。
4、启用用户专属记忆文件写入，确保USER.md与MEMORY.md位于HERMES_STATE_DIR子路径下且可被进程访问。
四、多模型切换与路由参数
Hermes Agent支持按任务类型动态选择最优模型，该行为由model_router.yaml规则文件驱动，需手动配置匹配条件与权重策略。
1、定位配置文件路径，通常为$HERMES_HOME/config/model_router.yaml。
2、使用文本编辑器打开该文件，确认顶层键routes存在且包含至少一个路由条目。
3、为代码理解任务添加规则：在routes下新增键值对，pattern: ".*code.*|.*debug.*"，对应model: "qwen-coder"。
4、为长文档摘要任务配置独立路由：pattern: ".*summarize.*|.*long.*context.*"，绑定model: "qwen-long"。
5、保存文件后执行hermes reload router命令热加载新路由规则，无需重启服务。
五、工具调用与模型协同参数
当Hermes Agent需调用终端、浏览器或文件系统等外部工具时，模型输出必须符合预定义的结构化Schema，该约束由TOOL_CALL_SCHEMA环境变量控制。
1、查看当前工具调用Schema版本：echo $TOOL_CALL_SCHEMA，标准值应为v2。
2、若返回为空或非v2值，执行export TOOL_CALL_SCHEMA=v2并写入环境配置文件。
3、验证工具插件是否启用：hermes list tools，确保shell、browser、file等关键插件状态为enabled。
4、检查各插件配置路径，例如~/.hermes/tools/shell/config.json中enable_sandbox字段应设为true以保障执行安全。
