需通过hermes model命令或手动编辑config.yaml等四种方式切换模型提供商：交互式命令自动更新配置并校验密钥；直接修改YAML文件精确控制base_url等参数；用.env文件动态注入环境变量实现会话级切换；同步清理旧密钥防止冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装 Hermes Agent 并希望更改默认调用的 AI 模型提供商（例如从 OpenAI 切换至 OpenRouter 或本地 Ollama），需通过修改配置文件或运行专用命令实现。以下是多种可行的操作路径：
一、使用 hermes model 命令切换提供商
该命令会启动交互式模型选择流程，自动更新 config.yaml 中的主模型配置，并校验 API 密钥有效性。
1、在终端中执行 hermes model 命令。
2、根据提示选择目标提供商（如 OpenRouter、Anthropic、Ollama 等）。
3、输入对应提供商的 API Key（若为 Ollama 则留空并确认）。
4、确认模型名称（如 openrouter/auto 或 ollama/llama3.2）。
5、等待配置写入完成，系统将显示 Model provider updated successfully 提示。
二、手动编辑 config.yaml 文件
此方法适用于需要精确控制 base_url、api_mode 或启用非标准端点的场景，直接修改主模型区段可绕过交互逻辑。
1、使用 VS Code 或记事本打开 ~/.hermes/config.yaml。
2、定位到顶部以 model: 开头的区块。
3、将 provider: 的值替换为目标提供商标识（如 openrouter）。
4、更新 model.default: 为对应模型 ID（如 anthropic/claude-3-5-sonnet-20241022）。
5、若使用自定义 API 地址，补充或修改 base_url: 行（如 https://openrouter.ai/api/v1）。
将 Claude Agent SDK 与 You.com HTTP MCP 服务器集成，支持 Python 和 TypeScript。当开发者提及 Claude Agent SDK、Anthropic Agent SDK 或将 Claude 与 MCP 工具集成时使用。
6、保存文件后，在终端运行 hermes doctor 验证配置合法性。
三、通过 .env 文件注入环境变量
当多个提供商共存且需按会话动态切换时，可借助 .env 文件覆盖默认 provider 设置，避免反复修改 config.yaml。
1、打开 ~/.hermes/.env 文件。
2、添加对应提供商的环境变量，例如：OPENROUTER_API_KEY=sk-or-xxx 或 OLLAMA_BASE_URL=http://localhost:11434。
3、在 config.yaml 中将 provider: 设为 auto 或留空。
4、启动 Hermes Agent 时，系统将依据已加载的环境变量自动匹配可用 provider。
5、验证是否生效：发送测试消息后检查日志中 Using provider: openrouter 类提示。
四、切换时禁用旧密钥残留影响
旧 API 密钥可能被缓存或触发错误 fallback 行为，需同步清理敏感字段防止冲突。
1、检查 ~/.hermes/.env 中是否存在已废弃的密钥行（如 OPENAI_API_KEY=）。
2、将该行整行注释（在行首添加 #）或删除。
3、运行 hermes setup --reset-auth 清除 OAuth 凭证缓存。
4、删除 ~/.hermes/auth.json 文件（如有）。
5、重启 Hermes Agent 进程确保新配置完全加载。
