Hermes Agent 自定义 endpoint 连不上,先查三件事:base URL 有没有带 /v1、API key 是否非空、模型名是否和服务端一致。官方 Providers 文档说明,Hermes 可以接任何 OpenAI-compatible endpoint,但前提是服务端真的实现 /v1/chat/completions。
最短配置样例
OPENAI_BASE_URL=http://localhost:8000/v1
OPENAI_API_KEY=local-key
LLM_MODEL=your-model-name
常见坑
- 本地服务只开在容器内部,Hermes 主机访问不到。
- base URL 少了
/v1。 - 本地服务不要求 key,但 Hermes/SDK 侧仍需要一个非空占位 key。
- 模型名写的是展示名,不是服务端注册名。
一句话:自定义 endpoint 不通,先用 curl 打通 /v1/chat/completions,再让 Hermes 接。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。