Hermes 如何接入第三方大模型 API：正确配置方法与 ClawSocket 示例
如果你想给 Hermes Agent 接第三方大模型 API，正确方法不是乱改环境变量，而是按 Hermes 官方文档提供的两条路来配：
- 用
hermes model走交互式配置 - 直接改
~/.hermes/config.yaml
Hermes 官方文档已经明确写到：Hermes Agent 可以连接任何 OpenAI-compatible API endpoint。只要目标服务实现 /v1/chat/completions，就可以接入。[^1]
先放入口：
快速结论
- Hermes 可以接第三方大模型 API
- 前提是目标服务是
OpenAI-compatible - 官方推荐做法是运行
hermes model - 如果你想手动配，改的是
~/.hermes/config.yaml - 核心只需要 3 个值：
Base URL、API Key、Model name
一、Hermes 正确的接入方法
Hermes 官方文档给出的通用接法是：
bash
hermes model然后按官方提示选择：
text
Custom endpoint (self-hosted / VLLM / etc.)接着依次输入：
text
API base URL
API key
Model name这就是 Hermes 官方推荐的第三方 API 接入方式。[^1]
二、Hermes 接第三方 API 的最短步骤
如果你只看步骤，照下面做：
- 安装并启动 Hermes
- 在终端执行
hermes model - 选择
Custom endpoint (self-hosted / VLLM / etc.) - 填入第三方接口的
Base URL - 填入
API Key - 填入
Model name - 保存后开始新会话测试
三、ClawSocket 的配置示例
如果你用 ClawSocket，可以直接按这个思路填：
text
API base URL: https://api.clawsocket.com/v1
API key: 你的-CLAWSOCKET-KEY
Model name: claude-sonnet-4-5如果你想换成别的模型，也只是改最后一项：
text
API base URL: https://api.clawsocket.com/v1
API key: 你的-CLAWSOCKET-KEY
Model name: gpt-5.5或者：
text
API base URL: https://api.clawsocket.com/v1
API key: 你的-CLAWSOCKET-KEY
Model name: gemini-3.1-pro-preview重点不是模型本身，而是这 3 个值必须来自同一个平台。
四、手动修改 config.yaml 的写法
Hermes 官方文档也给了手动配置方式。你可以直接改：
text
~/.hermes/config.yaml最小写法是：
yaml
model:
default: claude-sonnet-4-5
provider: custom
base_url: https://api.clawsocket.com/v1
api_key: your-key如果你要换模型，只改 default 即可：
yaml
model:
default: gpt-5.5
provider: custom
base_url: https://api.clawsocket.com/v1
api_key: your-key这也是 Hermes 官方文档明确给出的 custom endpoint 配置形态。[^1]
五、Hermes 里哪些旧方法不要再用
这里有一个很关键的点：Hermes 官方文档明确说过，旧的 LLM_MODEL .env 配置方式已经移除，config.yaml 才是模型和 endpoint 的单一配置来源。[^1]
也就是说：
- 不要再指望只改
LLM_MODEL - 不要把第三方 endpoint 配置散落在旧环境变量里
- 该用
hermes model或config.yaml
六、怎么验证有没有接成功
最简单的办法就是配置完以后开一个新会话，发一句：
text
请用三句话说明当前工作目录的用途如果 Hermes 能正常返回，就说明：
- Base URL 正常
- API Key 正常
- 模型名正常
七、最容易填错的地方
1. Base URL 少了 /v1
Hermes 对接的是 OpenAI-compatible endpoint，通常要填：
text
https://api.clawsocket.com/v12. 模型名写错
一定要以平台当前实际支持的模型名为准。
3. 还在用旧环境变量思路
Hermes 现在以 config.yaml 为主，不要继续依赖已经移除的 LLM_MODEL。
总结
Hermes 接第三方大模型 API 的正确方法就是：
bash
hermes model然后选择：
text
Custom endpoint (self-hosted / VLLM / etc.)再填入：
text
Base URL
API Key
Model name如果你用 ClawSocket，最简单的示例就是：
text
Base URL: https://api.clawsocket.com/v1
API Key: 你的-CLAWSOCKET-KEY
Model name: claude-sonnet-4-5如果你想继续看相关接入：
参考资料
[^1]: Hermes 官方 AI Providers 文档写明：支持任何 OpenAI-compatible API endpoint；交互式配置使用 hermes model 选择 Custom endpoint；手动配置写入 ~/.hermes/config.yaml；旧的 LLM_MODEL .env 方式已移除。