Hermes Agent

Hermes Agent 是 Nous Research 推出的智能体助手，支持在配置文件中通过 custom_providers 节点接入兼容 OpenAI 协议的自定义端点。

1. 存储 API Key 凭据

Hermes 默认将环境变量保存在用户目录下的 ~/.hermes/.env 文件中。可通过命令行写入密钥：

hermes config set ANYSTARX_API_KEY sk-...

也可以直接编辑该环境文件：

ANYSTARX_API_KEY=sk-...

2. 编辑 config.yaml 配置文件

打开 ~/.hermes/config.yaml 配置文件，声明服务商节点并设置为默认使用的模型：

custom_providers:
  "anystarx":
    base_url: https://console.anystarx.com/v1
    api_key_env: ANYSTARX_API_KEY

model:
  default: MODEL_ID
  provider: "anystarx"

将 MODEL_ID 替换为控制台模型列表中复制的完整模型标识符。base_url 仅填写至 /v1，Hermes 会自动追加具体业务路径。

3. 校验配置与连通测试

在终端中执行配置检查命令：

hermes config check
hermes config get model

随后启动交互式会话验证模型连通性：

hermes chat

也可以在启动命令行中通过 --model 参数临时指定模型：

hermes chat --model MODEL_ID

常见问题排查

• 提示鉴权失败：核实 ~/.hermes/.env 中是否已定义 ANYSTARX_API_KEY，并确认 custom_providers 节点下的 api_key_env 字段名称与之严格一致。
• 提示模型不存在：确认 model.default 填入的是控制台模型列表中的完整 ID，避免使用自行简化的缩写。
• 请求仍发送至官方服务商：检查 model.provider 是否准确设置为 anystarx，避免保留内置提供商名称。

更多配置项可查阅 Hermes Agent Configuration。