OptiWaves
手册产品站
客户端

Hermes Agent

配置命名 provider、密钥引用和 Responses 传输方式。

先按准备 API Key设置 OPTIWAVES_API_KEY。本页使用支持 providers 字典与 transport 字段的 Hermes 配置格式。

1. 找到配置目录

Hermes 默认读取 ~/.hermes/config.yaml。设置过 HERMES_HOME 时，编辑该目录下的 config.yaml。

如果在 Windows 的 Linux 环境中运行 Hermes，配置与密钥都应在运行 Hermes 的同一个环境中设置；Windows 终端里的变量不会自动成为另一环境的变量。

2. 添加 OptiWaves provider

config.yaml
providers:
  optiwaves:
    name: OptiWaves
    base_url: https://api.optiwaves.app/v1
    key_env: OPTIWAVES_API_KEY
    transport: codex_responses
    default_model: auto

model:
  provider: optiwaves
  default: auto

agent:
  reasoning_effort: medium

key_env 填 API Key 的环境变量名称，transport 设为 codex_responses，模型填写 OptiWaves 的 ID，例如 auto。

也可以把密钥保存在 Hermes 私有目录的 .env 中：

~/.hermes/.env
OPTIWAVES_API_KEY=ow_your_api_key_here

将占位值替换为自己的密钥。配置与密钥文件不要放进共享项目仓库。

3. 启动并验证

hermes

选择 OptiWaves / Auto 并发送一个问题。连接失败时，运行 hermes doctor 查看配置问题。

4. 切换模型

修改 model.default 和 provider 的 default_model，例如都改为 auto-fast，然后重启 Hermes。显式模型也应使用 OptiWaves 的模型 ID，权限与消耗见模型与价格。

常见问题

情况检查
提示未知 provider确认版本支持 providers 字典，并且 model.provider 对应 optiwaves
没有读到密钥检查 key_env 名称、启动环境和 Hermes 自己的 .env
走了 Chat Completions检查 transport 是否为 codex_responses，以及旧配置是否覆盖它
修改后仍用旧模型重启 Hermes，检查会话内已选择的模型与当前配置

完整格式见 Hermes 模型提供方文档。返回客户端选择。

本地记忆

API 接通后，可用 OptiWaves CLI 为这个客户端配置本地记忆：

optiwaves memory --client hermes

重启客户端后，用一次保存和一次新会话召回检查结果。具体路径与限制见本地记忆。

售后群 1055897442

本页