需升级hermes agent至v0.8.0+，配置minimax provider参数，再通过/model命令或环境变量hermes_default_model切换模型。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用Hermes Agent并希望将当前任务的底层大模型从GPT-4切换至MiniMax（如M2.7），则需绕过默认OpenAI路径，显式配置MiniMax Provider并完成模型路由绑定。以下是执行该迁移的具体步骤：
一、验证Hermes Agent版本兼容性
MiniMax接入依赖v0.8.0及以上版本的Provider抽象层，旧版本无法识别其请求结构（如非标准system字段位置、token计数逻辑差异）。必须确认运行环境满足基础前提，否则后续配置将触发400错误或静默降级。
1、在终端中执行：pnpm list hermes-agent
2、检查输出是否显示版本号 ≥ 0.8.0；若为0.7.x或更低，请立即升级：pnpm add hermes-agent@latest && pnpm build
3、启动Agent后访问管理界面，在“Settings → Model Providers”中确认列表包含minimax条目。
二、配置MiniMax API凭证与端点
Hermes Agent不自动读取MINIMAX_API_KEY环境变量，必须通过config.yaml显式声明Provider参数，且base_url、api_key、default_model三者缺一不可，否则调用将返回401或404。
1、打开项目根目录下的config.yaml文件，定位至providers区块
2、在providers下新增以下YAML块（严格使用空格缩进，禁止tab）：minimax: { api_key: "${MINIMAX_API_KEY}", base_url: "https://api.minimax.chat/v1", default_model: "abab6.5-chat" }
3、在shell中导出密钥：export MINIMAX_API_KEY="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.xxxx"
4、重启Hermes Agent进程以加载新配置：hermes stop && hermes start
三、通过/model命令强制切换至MiniMax模型
该方法绕过环境变量预设，直接在会话中触发Provider路由重定向，适用于单次任务迁移，不影响全局默认模型设置。系统将校验minimax Provider是否已激活，未配置时会提示“Provider not found”。
1、在hermes>提示符下输入：/model，确认输出列表中出现minimax/abab6.5-chat等选项
2、执行切换指令：/model minimax/abab6.5-chat
使用APIDot进行MiniMax Music 2.6 API工作流程，包括AI音乐生成、歌词创作、器乐制作、音频导出规划、异步任务提交、任务ID...
3、观察终端返回提示：Switched to provider: minimax, model: abab6.5-chat
4、发送测试消息验证响应头是否含x-minimax-request-id字段
四、使用OpenRouter网关间接调用MiniMax
当已配置OpenRouter API密钥时，可复用其统一网关能力，避免单独维护MiniMax凭证。OpenRouter将自动映射minimax/abab6.5-chat至对应后端，且支持流式响应与token统计透传。
1、确保config.yaml中已启用openrouter Provider，并填入有效API密钥
2、在会话中执行：/model openrouter/minimax/abab6.5-chat
3、系统将跳过本地minimax Provider校验，直连OpenRouter路由层
4、首次调用时可能延迟1–2秒，因OpenRouter需建立下游连接池
五、通过环境变量固化MiniMax为会话默认模型
该方式适用于长期使用MiniMax处理中文长文本、高性价比推理场景，所有新启动会话将自动绑定minimax Provider，无需重复输入/model指令。
1、在启动前设置环境变量：HERMES_DEFAULT_MODEL=minimax/abab6.5-chat
2、Linux/macOS用户执行：export HERMES_DEFAULT_MODEL=minimax/abab6.5-chat && hermes start
3、Windows PowerShell用户执行：$env:HERMES_DEFAULT_MODEL="minimax/abab6.5-chat"; hermes start
4、启动后输入/model，确认当前模型显示为minimax/abab6.5-chat
