Hermes Agent 接入 OneLinkAI

Hermes Agent v0.20.0，模型用 deepseek-v4-flash。

配置在两个文件：密钥放 ~/.hermes/.env，端点放 ~/.hermes/config.yaml。

一、写密钥

编辑 ~/.hermes/.env，加一行：

编辑 ~/.hermes/config.yaml，改 model 段并加 providers 段：

providers: 下的 onelinkai 是自己起的名字，model.provider 填一样的就行。

三个注意点：

api 必须带 /v1。Hermes 自己拼 /chat/completions，不要手动加。

用 key_env 指向 .env 的变量名，别把 key 明文写进 config.yaml。

如果 config.yaml 里 model: 原来是空字符串，那是全新安装的占位值，按上面改成字典格式即可。

不想手改的话跑 hermes setup model，交互式向导会写好这两个文件。

先确认密钥本身可用：

返回里有 choices 就是通了。再看 Hermes 读到的配置：

然后直接开聊：

会话内临时切：

/model deepseek-v4-flash --provider onelinkai

加 --global 同时写入配置文件。

配置改动对新会话生效，已经开着的会话保持原模型。网关（Telegram 等）需要 hermes gateway restart 才会全部刷新。

现象	处理
`404 page not found`	Base URL 少了 `/v1`
"No authenticated providers"	.env 里的变量名和 `key_env` 不一致
会话里模型没变	正常，活进程不重读配置，用 `/model` 热切
502 Upstream access forbidden	上游拒绝 SDK 默认 UA，加 `extra_headers: {User-Agent: "curl/8.7.1"}`