​
概述

Hermes Agent 是一个开源的通用智能体框架（CLI + 多平台网关），结构上与 OpenClaw、Claude Code 等产品类似：统一的工具箱（终端、文件、浏览器、Web 搜索、图片生成、TTS、技能、MCP 等）+ 可插拔的推理后端。 本文档将指导你如何将 Nonelinear API接入 Hermes Agent。

​
前置条件

  1. 获取 API Key：准备一个 NoneLinear API Key（获取 API Key）。后面需要填入配置文件
  2. 安装 Hermes Agent：
    • macOS / Linux / WSL2 / Termux: 
      curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
    • Windows (PowerShell): 
      irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex
    安装完成后，会进入初始化向导，按照提示完成配置（也可之后通过 hermes setup 随时开启），其中：
    • Select provider: 在菜单中选择 Custom endpoint (enter URL manually)。
    • API base URL: 输入 https://api.nonelinear.com/v1。
    • API key: 填入你的 NoneLinear API Key，填入之后会在config.yaml里。也可先跳过，后续在配置文件.env中设置。
    • Model name: 输入默认模型 ID（例如 deepseek-v3.2）。
  3. 配置文件说明：Hermes 的配置存储在 ~/.hermes/ 目录：
    • ~/.hermes/config.yaml — 核心配置文件（模型、工具、后端等）
    • ~/.hermes/.env — API Key 等敏感环境变量

​
Hermes Agent 接入方式：OpenAI 兼容协议

NoneLinear 的 https://api.nonelinear.com/v1 完全兼容 OpenAI SDK 格式，支持 文本对话、图片生成、视频生成 等所有场景。 如果你在安装阶段跳过了配置，或后续需要更换模型、重新配置，可以通过以下两种方式进行设置。

​
方式一：交互式配置（最简单）

hermes model
# 在菜单中选择 "Custom endpoint (enter URL manually)"
# API base URL:  https://api.nonelinear.com/v1
# API key:       直接粘贴你的 NoneLinear API Key
# Model name:    输入默认模型 ID，例如 claude-sonnet-4.6、gpt-5.4-high

​
方式二：手动修改 config.yaml

编辑 ~/.hermes/config.yaml，找到 model: 段并修改为： 
model:
  default: claude-sonnet-4.6       # 你要用的默认模型 ID
  provider: custom                 # 固定为 custom
  base_url: https://api.nonelinear.com/v1
在 ~/.hermes/.env 中写入 API Key： 
# Hermes 对 provider: custom 的 endpoint 默认读取 OPENAI_API_KEY
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
提示：config.yaml 里已有 Hermes 自动生成的大量默认配置，只修改 model: 这一段即可，其它段落保持不动。

​
配置多个 NoneLinear 大模型并随时切换

NoneLinear 模型超市里有多个模型，Hermes 支持在同一个对话里随时切换——切换后对话历史、记忆、正在执行的任务都不会丢。 “配置多个模型”在 Hermes 里有两种做法，推荐按需组合使用。

​
方式一：对话中直接切换（零配置）

只要你按上一节接好了 NoneLinear，对话里直接输入裸模型名（不加任何前缀）就能切到任意 NoneLinear 模型： 
/model claude-opus-4.6
/model gpt-5.4-high
/model Kimi-K2.5-Thinking
/model MiniMax-M2.7
/model GLM-5.1
/model qwen3.5-plus
重要：不要加 custom: 前缀。/model custom:xxx 这种写法是从其他 provider 切换到 custom 时才用的；你当前 model.provider 已经是 custom，直接写模型名即可。如果误加了 custom: 前缀，Hermes 会把整串（例如 custom:qwen3.5-plus）当成模型 ID 发给 NoneLinear，NoneLinear 会返回 HTTP 422: model_id错误或不支持。

​
方式二：给常用模型起短别名（推荐）

如果不想每次打全模型 ID，在 ~/.hermes/config.yaml 末尾追加下面这段 model_aliases:（其它内容一个字都不要动）： 
model_aliases:
  opus:
    model: claude-opus-4.6
    provider: custom
    base_url: https://api.nonelinear.com/v1
  sonnet:
    model: claude-sonnet-4.6
    provider: custom
    base_url: https://api.nonelinear.com/v1
  gpt:
    model: gpt-5.4-high
    provider: custom
    base_url: https://api.nonelinear.com/v1
  kimi:
    model: Kimi-K2.5-Thinking
    provider: custom
    base_url: https://api.nonelinear.com/v1
  minimax:
    model: MiniMax-M2.7
    provider: custom
    base_url: https://api.nonelinear.com/v1
  glm:
    model: GLM-5.1
    provider: custom
    base_url: https://api.nonelinear.com/v1
  qwen:
    model: qwen3.5-plus
    provider: custom
    base_url: https://api.nonelinear.com/v1
保存文件，重启 hermes。之后在对话里就可以用一个单词切换： 
/model opus       # 切到 Claude Opus 4.6（处理复杂任务）
/model gpt        # 切到 GPT-5.4 High
/model kimi       # 切到 Kimi K2.5 Thinking（长思考）
/model qwen       # 切到 qwen3.5-plus（便宜快，用于简单问题）

​
验证是否切换成功

对话里直接输入 /model（不带参数），Hermes 会打印当前使用的模型： 
/model
# 输出示例：
# Current model: claude-opus-4.6
# Provider: custom (https://api.nonelinear.com/v1)
完整模型列表请见 NoneLinear 模型广场。

​
相关链接