在 Hermes Agent 聊天里输入 /model 失败,常见原因是你还没有在终端配置对应 provider。/model 主要用于会话内切换已配置模型,不负责新增账号、OAuth 或 API key。
官方 CLI 文档把两者分得很清楚:hermes model 是终端里的完整 provider 设置向导;/model 是聊天会话里的快速切换命令。把这个区别搞清楚,很多模型报错就不用反复试了。
正确处理步骤
第一步,退出当前 Hermes 会话,回到系统终端。第二步,运行 hermes model,按提示添加 OpenRouter、Anthropic、OpenAI、Nous Portal、自定义 endpoint 或其他支持的 provider。第三步,确认 API key 或 OAuth 登录成功后,再重新进入 hermes。
重新进入会话后,再输入 /model 查看可用模型。如果只配置了 OpenRouter,你看到的也只会是 OpenRouter 相关选项;想用别的 provider,就必须先回终端添加。
自定义 endpoint 怎么排查
自托管或兼容 OpenAI 的接口,重点检查 base URL、模型名、认证 header 和网络连通性。切换离开 custom provider 后,也要确认旧 base URL 没有继续影响其他 provider。官方文档提到 provider 和 base URL 会写入配置,排查时可以看 hermes config。
如果还是失败,跑 hermes doctor 看环境和配置摘要,再检查日志。不要在聊天里一直换模型名,先确认 provider 层已经配置成功。模型切换问题通常不是模型“不支持”,而是账号、端点或配置位置不对。