快速找到所需文档，高效完成接入与排障

3.1 安装

macOS 或 Linux 使用官方安装脚本：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows 原生 PowerShell：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Unix 或 WSL 安装后，可按当前 Shell 重新加载环境：

source ~/.bashrc# 使用 zsh 时执行：source ~/.zshrchermes --version

3.2 配置

Hermes Agent 的配置文件为 ~/.hermes/config.yaml。当前版本使用顶层 providers 字典定义自定义 OpenAI-compatible Provider，并将 model.api_mode 设为 chat_completions。不要使用 anthropic_messages 模式。

先设置密钥环境变量：

export U_ROUTER_API_KEY="<YOUR_U_ROUTER_API_KEY>"

再编辑 ~/.hermes/config.yaml：

providers:
  umeng-u-router:
    api: https://ai.umeng.com/api/llm/v1
    key_env: U_ROUTER_API_KEY
    models:
      - auto

model:
  provider: umeng-u-router
  default: auto
  api_mode: chat_completions

U-Router 的 OpenAI 兼容端点为 POST /api/llm/v1/chat/completions，Base URL 为 https://ai.umeng.com/api/llm/v1。api 是 base_url 的别名，填入完整 Base URL 即可；Hermes 会自动拼接 /chat/completions，不会重复路径。

如需指定具体模型，直接把支持的模型 ID（如 qwen3.8-max、deepseek-r1 等）加入 providers.umeng-u-router.models 并改 model.default。

3.3 验证

hermes chat -q "你好"

具体文本模型 ID 已确认后，可指定模型测试：

hermes chat --model <MODEL_ID> -q "你好"

若出现 404，优先核对 Hermes Agent 自动追加的路径是否最终命中 U-Router 的 /api/llm/v1/chat/completions。