Hermes Agent

Hermes Agent 是 Nous Research 维护的命令行 AI Agent。官方文档确认 Hermes 可以连接任意实现 /v1/chat/completions 的 OpenAI 兼容端点，并推荐通过 hermes model 或 ~/.hermes/config.yaml 配置自定义端点。Sakrylle API 兼容 OpenAI Chat Completions，因此可以作为 Hermes 的 custom provider 使用。

• 官网：https://hermes-agent.nousresearch.com
• AI Providers 文档：https://hermes-agent.nousresearch.com/docs/integrations/providers
• 环境变量文档：https://hermes-agent.nousresearch.com/docs/reference/environment-variables
• Provider runtime 文档：https://hermes-agent.nousresearch.com/docs/developer-guide/provider-runtime

前置准备

1. 已按 Hermes 官方说明安装 Hermes Agent。
2. 在 Sakrylle 控制台 创建一个 API Key。
3. 这把 Key 所属分组包含你要使用的模型；聊天示例使用 gpt-5.6-sol。

方式一：交互式配置

Hermes 官方推荐用 hermes model 做完整 provider 设置：

hermes model

在向导中选择 Custom endpoint，然后填写：

字段	填写
API base URL	https://api.sakrylle.com/v1
API key	sk-xxxxxxxxxxxxxxxx
Model name	gpt-5.6-sol
API mode	chat_completions

完成后启动 Hermes：

hermes chat

进入会话后发送一条简单消息。如果回复正常，配置就已生效。

方式二

如果你想手动配置，建议按 Hermes 官方文档中的 named custom provider 形态编写。这样 Key 可以放在 ~/.hermes/.env，模型切换也更清晰。

字段说明：

• custom_providers[].name：自定义提供商名称；示例使用 sakrylle。
• base_url：Sakrylle 的 OpenAI 兼容入口，带 /v1。
• key_env：Hermes 从这个环境变量读取 API Key。
• api_mode: chat_completions：使用 OpenAI Chat Completions 兼容模式。
• model.provider: custom:sakrylle：把默认 provider 指向这个 named custom provider。
• model.default：默认模型名；示例使用 Sakrylle 推荐的 OpenAI 兼容默认模型 gpt-5.6-sol。

Hermes 的 provider 文档说明，持久化的模型、provider 与 base URL 配置应以 config.yaml 为准；如果你曾按旧教程设置过 .env 里的模型或端点变量，请用 hermes model 或下面的 config.yaml 重新确认当前生效配置。

~/.hermes/.env：

SAKRYLLE_API_KEY=sk-xxxxxxxxxxxxxxxx

~/.hermes/config.yaml：

custom_providers:
  - name: sakrylle
    base_url: https://api.sakrylle.com/v1
    key_env: SAKRYLLE_API_KEY
    api_mode: chat_completions

model:
  provider: custom:sakrylle
  default: gpt-5.6-sol

在会话里切换模型时使用 Hermes 的 triple syntax：

/model custom:sakrylle:gpt-5.6-sol

Claude 模型用法

Hermes 原生支持 Anthropic Messages API，也支持在 named custom provider 里把 api_mode 设为 anthropic_messages。但对于 Sakrylle，一般建议先使用上面的 OpenAI 兼容入口：https://api.sakrylle.com/v1 + api_mode: chat_completions。Sakrylle 的 /v1/chat/completions 也可路由到 Claude 系列模型，配置方式与 GPT 模型一致，只需把模型名换成可用的 Claude 模型。

例如：

custom_providers:
  - name: sakrylle
    base_url: https://api.sakrylle.com/v1
    key_env: SAKRYLLE_API_KEY
    api_mode: chat_completions

model:
  provider: custom:sakrylle
  default: claude-haiku-4-5-20251001

只有在你明确需要 Anthropic Messages 原生字段，并且已经确认当前 Sakrylle 端点与 Hermes 的 anthropic_messages 模式兼容时，才改用 Anthropic 模式。否则保持 chat_completions 更稳妥。

常见问题

• 401 / 鉴权失败：确认 api_key 或 SAKRYLLE_API_KEY 是有效的 Sakrylle Key。
• 404 / model not found：把 default 改成 模型与计费 中列出的有效模型。
• 配置了 .env 但没有生效：Hermes 官方文档说明模型、provider、base URL 的来源是 config.yaml；请运行 hermes model 或直接编辑 ~/.hermes/config.yaml。
• 想切回其他 provider：运行 hermes model 重新选择，或在会话中用 /model 切换已经配置过的 provider。
• 402 余额不足：到 控制台充值。