# Hermes Agent 接入指南

https://omnimodel.me/apps/hermes-agent?lang=zh

> Nous Research 的开源终端代理，能写代码、跑命令，也能长期记住你的偏好。

## 适用场景

适合想要一个能长期使用的终端代理：它能写代码、跑命令，并在多次会话之间积累记忆和技能。自定义端点通过 `hermes model` 的 Custom endpoint 设置，结果写进 `~/.hermes/config.yaml`。

## 使用建议

编程代理一次任务会连续发出很多请求，输入也长，建议选上下文较长、支持工具调用的模型，并给密钥设置每日消费上限。

## 推理档位

发不发推理档位取决于你在配置里给模型设的推理参数（Chat 接口的 `reasoning_effort`）。平台按模型实际走的线路能接受的档位处理：上游不收请求的档位时改用更高一档，高过最高档时取最高档；模型不能关闭思考时，要求关闭会返回 422 `model.reasoning_off_unsupported`。每个模型的对照表见[模型目录](/catalog)里该模型的「推理档位」一节；发生改写的调用，用量明细里会显示「推理档位改写」。

## 连不通时检查

1. API 地址填 `https://omnimodel.me/v1`，不要多写 `/chat/completions`。
2. 密钥以 `key_` 开头且没有被暂停或撤销，错误码 `auth.invalid_key` 表示密钥不可用。
3. 模型 ID 与[模型目录](/catalog)一致，并且在这把密钥的可用模型里。
4. 余额不足会返回 `billing.insufficient_credit`，更多错误见[常见错误](/docs/errors)。

## 配置步骤

1. 安装：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash。
2. 执行 hermes model，选 Custom endpoint，依次填入下面的 API 地址、密钥与模型 ID；也可以直接把下面这段写进 ~/.hermes/config.yaml。
3. 执行 hermes 开始对话。

## 配置参数

- API 地址：`https://omnimodel.me/v1`
- API 密钥：`YOUR_API_KEY`
- 模型：`MODEL_ID`

> 这份配置按 Hermes Agent 官方文档整理，平台尚未实测，遇到问题请提交工单并附上请求 ID。

```yaml
model:
  provider: custom
  base_url: https://omnimodel.me/v1
  api_key: YOUR_API_KEY
  default: MODEL_ID
```

## 常见问题

### 启动时提示上下文太小怎么办？

Hermes Agent 要求模型至少有 64K 上下文。请换一个上下文更长的模型；如果模型本身够长但没被识别，在 config.yaml 的 model 下加 context_length。

### 设置 OPENAI_BASE_URL 环境变量有用吗？

没用。自定义端点只认 hermes model 或 config.yaml 里的 base_url。