首次配置和替换已有都在 Hermes 会话外运行 hermes model。当前会话里的 /model 只能切换已经配置的 provider，不能新增连接。
选择配置方式
- 首次配置：运行
hermes model，新增 XiuRouter Custom endpoint。 - 替换已有：保留原 provider，新增 XiuRouter 后在新会话切换。
- 对话协助：不提供。当前 Hermes 对话不能新增 provider，必须退出会话运行向导。
前置条件
hermes --version可以正常输出版本。- 已创建一把 Hermes 专用 XiuRouter API Key。
- 准备在 Hermes 中从 endpoint 模型列表选择模型。
Hermes 的 Agent 工具需要至少 64,000 Token 的上下文。不要根据模型名称猜上下文长度；填写模型或服务来源实际支持的值。
添加 Custom endpoint
在 Hermes 会话外运行：
hermes model按提示完成配置：
Provider: Custom endpoint (self-hosted / VLLM / etc.)
Base URL: https://router-api.xiu.ai/v1
API Key: 你的 XiuRouter API Key
Model: 从 endpoint 的 /v1/models 列表选择
API mode: Chat Completions
Context length: 先用自动检测；失败时填实际支持值Hermes 会通过 endpoint 的 /models 参与模型和上下文解析。不要在 XiuRouter 页面预选模型，也不要根据模型名称猜上下文。不要把真实 Key 写进项目仓库、共享脚本或截图。
验证
- 新建 Hermes 会话，确认当前 provider 和模型是刚添加的 XiuRouter 配置。
- 先发送一个短文本请求。
- 再要求 Hermes 只读取当前目录并报告路径，不修改文件。
- 在 XiuRouter 控制台“检查实际请求”核对 Key、模型、
/v1/chat/completions和成功状态。
文本回复只能证明基础 Chat Completions 可用。Hermes 的终端、文件和其他工具依赖模型正确返回工具调用；至少完成一次只读工具任务后再扩大权限。
常见失败
| 现象 | 处理 |
|---|---|
/models 或模型探测返回 401 |
重新运行 hermes model，确认保存的是有效 XiuRouter API Key |
| Hermes 拒绝启动 Agent | 核对填写的上下文长度是否达到 64,000 Token |
请求走到 /v1/responses |
把 Custom endpoint 的 API mode 改回 Chat Completions |
| 普通回复成功但工具不执行 | 换用已验证工具调用的模型，并检查模型实际上下文 |
| 长任务中断 | 确认 Base URL 使用 router-api.xiu.ai，不是控制台域名 |
回滚
再次运行 hermes model，切回原 provider 和模型。确认新会话恢复原路由后，再撤销 Hermes 专用 XiuRouter API Key。
来源与核对日期
内容核对于 2026-08-31。Hermes Agent 收到完整回复并出现对应使用记录后，基础接入才算完成；上下文和工具能力请使用实际模型验证。