HermesAgent怎么换模型？OpenRouter与OpenAI一键切换教程【配置】

实现Hermes Agent在OpenRouter与OpenAI间一键切换需四路径：一、交互式执行hermes model命令选提供商并输密钥与模型名；二、手动修改config.yaml中llm区块的provider、base_url和model字段；三、通过环境变量临时注入OPENROUTER_API_KEY或OPENAI_API_KEY及对应MODEL；四、运行时用hermes run --model provider:model-id动态指定。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已部署 Hermes Agent，但希望在 OpenRouter 与 OpenAI 之间快速切换模型提供商，可能是由于配置未覆盖默认后端、API 密钥缺失或模型标识格式错误所致。以下是实现一键切换的多种独立操作路径：

一、使用 hermes model 命令交互式切换

该命令自动更新 config.yaml 中的主模型配置，并校验对应提供商的 API 密钥有效性，适用于日常高频切换场景。

1、在终端中执行 hermes model 命令。

2、根据提示选择目标提供商：OpenRouter 或 OpenAI。

3、输入对应密钥：若选 OpenRouter，粘贴 sk-or-v1-xxxxxxxx...；若选 OpenAI，粘贴 sk-proj-xxxxxxxx...。

4、确认模型名称：OpenRouter 示例为 openrouter/anthropic/claude-3.5-sonnet，OpenAI 示例为 openai/gpt-4o。

5、等待终端输出 Model provider updated successfully 提示。

二、通过 config.yaml 手动修改后端参数

此方法绕过交互逻辑，直接在配置文件中声明 provider 类型、base_url 和模型 ID，适用于容器化部署或需版本控制的环境。

1、使用编辑器打开 ~/.hermes/config.yaml 或项目根目录下的 config.yaml。

2、定位到 llm: 区块，确保其下包含完整结构。

3、若切换至 OpenRouter，设置：
provider: "openrouter"
base_url: "https://openrouter.ai/api/v1"
model: "google/gemma-2-9b-it"

4、若切换至 OpenAI，设置：
provider: "openai"
base_url: "https://api.openai.com/v1"
model: "gpt-4o"

5、保存文件后，在终端运行 hermes doctor 验证 YAML 语法与配置合法性。

Claude Code 2.1.81

Claude Code 2.1.81

三、通过环境变量临时注入并启动

该方式不修改任何持久化配置，仅在当前 Shell 会话中生效，适合开发调试或临时验证不同模型行为。

1、打开终端，确保位于 Hermes Agent 可执行路径下。

2、切换至 OpenRouter：执行 export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxx..." 与 export OPENROUTER_MODEL="anthropic/claude-3.5-sonnet"。

3、切换至 OpenAI：执行 export OPENAI_API_KEY="sk-proj-xxxxxxxx..." 与 export OPENAI_MODEL="gpt-4o"。

4、验证变量是否加载成功：分别执行 echo $OPENROUTER_API_KEY 或 echo $OPENAI_API_KEY，应返回非空字符串。

5、启动 Hermes Agent：执行 hermes run --model openrouter 或 hermes run --model openai。

四、运行时动态覆盖默认模型

无需重启进程或修改配置，单次命令即可指定模型通道与具体 ID，适用于多阶段任务中按需调用不同能力模型。

1、调用 OpenRouter 模型：执行 hermes run --model openrouter:mistralai/mistral-7b-instruct。

2、调用 OpenAI 模型：执行 hermes run --model openai:gpt-3.5-turbo。

3、混合调用示例：执行 hermes run --model openrouter:qwen/qwen2.5:free --model openai:gpt-4o（注：实际不支持双 --model，此处仅示意语法结构）。

4、确认终端输出首行显示 Using model provider: openrouter 或 Using model provider: openai。