实现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 语法与配置合法性。
三、通过环境变量临时注入并启动
该方式不修改任何持久化配置，仅在当前 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。
