需通过本地文件系统、环境变量及运行时注册状态三方面交叉验证:一、检查config.yaml中主模型定义;二、核验.env中对应api密钥是否存在;三、查看模型注册表缓存状态;四、运行诊断命令获取实时加载报告;五、检查运行容器日志中的模型初始化记录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您需要确认Hermes Agent当前加载的模型配置是否完整、有效且与预期一致,则需通过本地文件系统、环境变量及运行时注册状态三方面交叉验证。以下是查看当前模型配置状态的具体步骤:
一、检查config.yaml中主模型定义
该步骤用于确认默认模型标识、服务提供商、API地址等核心参数是否已正确声明。主模型配置直接决定Agent发起请求时所调用的目标模型。
1、使用文本编辑器或命令行打开主配置文件:~/.hermes/config.yaml
2、定位到model:区块,检查default:字段值是否为合法格式,例如openai/gpt-4o或minimax/abab6.5s
3、确认provider:、base_url:、api_mode:等字段是否存在且非空;若缺失base_url但provider:为auto,则依赖Providers层配置
二、核验.env中对应API密钥是否存在
该步骤用于验证敏感凭证是否已写入环境变量文件,并确保其变量名与config.yaml中引用的模型提供商严格匹配,避免因密钥缺失导致模型初始化失败。
1、执行命令查看.env文件内容:cat ~/.hermes/.env
2、根据config.yaml中指定的default:模型前缀(如openai/),查找对应变量名(如OPENAI_API_KEY)是否已定义
3、确认该变量值不为空且未被注释(即行首无#),例如OPENAI_API_KEY=sk-prod-xxxxxxxxxx
三、查看模型注册表缓存状态
该步骤用于判断Hermes Agent是否已完成对environments/model_configs/目录下YAML配置文件的解析与注册,反映实际可用模型集合。
1、检查模型注册缓存文件是否存在:ls -l ~/.hermes/.model_registry_cache.pkl
2、若文件存在,查看其最后修改时间是否晚于environments/model_configs/目录下任意YAML文件的修改时间
3、若缓存文件不存在,说明Agent尚未完成首次模型注册,或曾执行过rm -f ~/.hermes/.model_registry_cache.pkl清除操作
四、运行诊断命令获取实时加载报告
该步骤调用内置诊断工具,输出模型解析过程中的关键节点状态,包括配置文件读取路径、环境变量注入结果、schema校验反馈及注册模型列表。
1、在Hermes工作目录下执行诊断命令:hermes doctor --section model
2、观察输出中Model config file字段是否指向正确的config.yaml路径
3、检查Loaded providers与Available models区块是否列出预期模型名称,若显示0 models loaded,则表明配置解析失败
五、检查运行容器日志中的模型初始化记录
该步骤用于捕获Agent启动过程中动态加载模型时的实际行为,可发现YAML语法错误、字段类型不匹配或endpoint 404等运行时异常。
1、获取当前Hermes容器ID:docker ps -q --filter "name=hermes"
2、查看最近100行启动日志:docker logs $(docker ps -q --filter "name=hermes") | tail -n 100
3、搜索关键词registering model或failed to load config,确认是否有模型被成功注册,或是否存在KeyError、ValidationError类报错











