Hermes Agent功能异常通常源于config.yaml关键参数配置错误或缺失：需检查server（host/port/shutdown_timeout）、mq（type/brokers/uri）、executor（type/max_workers）、模型与.env密钥分离、容器化资源配额（CPU/内存/GPU）五类参数。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装Hermes Agent但功能未按预期运行，则可能是由于config.yaml中关键参数配置不准确或缺失。以下是针对核心参数的进阶配置步骤：
一、基础服务参数配置
该部分定义Hermes Agent的运行身份、监听地址及基本生命周期控制，直接影响服务能否正常启动和对外通信。
1、打开config.yaml文件，定位到server根节点下。
2、确认host字段值为合法IPv4或IPv6地址，例如"0.0.0.0"表示监听所有网卡；若设为"127.0.0.1"则仅本地可访问。
3、检查port字段是否为非特权端口（1024以上）且未被其他进程占用，推荐使用8080或9090作为默认端口。
4、验证shutdown_timeout是否为正整数，单位为秒，该值决定优雅关闭时等待任务完成的最长时间。
二、消息队列连接参数配置
此部分控制Hermes Agent与后端消息中间件（如Kafka、RabbitMQ）的连接行为，错误配置将导致消息无法投递或消费中断。
1、进入mq配置块，确认type字段值为"kafka"或"rabbitmq"，必须与实际部署的中间件类型严格一致。
2、在kafka子块中，检查brokers列表是否包含全部Broker地址，格式为["host1:9092", "host2:9092"]；至少需配置一个可用Broker地址才能建立初始连接。
3、在rabbitmq子块中，确保uri字段以amqp://开头，且用户名、密码、vhost均经过URL编码，例如amqp://user%40example:pass%23123@192.168.1.10:5672/%2Fmyvhost。
4、核对max_reconnect_attempts是否大于0，该参数限制重连失败后的最大尝试次数，设为0将禁用自动重连机制。
三、任务执行器参数配置
该部分决定Hermes Agent如何调度与执行用户定义的任务，影响并发能力、超时控制及资源隔离策略。
1、查找executor配置节，确认type字段为"thread_pool"或"process_pool"，前者适用于I/O密集型任务，后者适用于CPU密集型任务。
2、检查max_workers数值是否匹配宿主机CPU核心数或内存容量，线程池模式下建议设为2 * CPU核心数，进程池模式下不建议超过CPU核心数 + 2。
四、模型与API密钥分离配置
该方式将模型逻辑与敏感凭证解耦，提升安全性与配置复用性，避免密钥硬编码在YAML中。
1、在config.yaml中配置model节，指定provider与model_name，例如openai/gpt-4o。
2、在~/.hermes/.env文件中添加对应密钥变量，如OPENAI_API_KEY=sk-xxxxx。
3、确认Hermes Agent运行时能正确加载.env环境变量，可通过hermes doctor命令验证密钥读取状态。
五、容器化部署资源配额配置
当Hermes Agent以Docker方式运行时，需显式声明资源限制，防止因资源争抢导致服务异常或系统OOM。
1、在docker-compose.yml或Kubernetes manifest中添加resources节。
2、设置cpu_shares为1024以保障基础CPU权重，配合cpu_quota与cpu_period实现精确时间片控制。
3、配置memory.limit为4G，memory_reservation为2G，swap_limit为8G。
4、若启用GPU加速，在gpu子节中指定device_ids为[0]，并设置memory_limit为10G。
