Hermes Agent模型配置有五种方式：一是运行hermes setup交互式向导快速选择服务商并填API Key；二是编辑~/.hermes/.env文件注入OPENAI_API_KEY等密钥；三是用hermes model命令直连Custom endpoint自定义Base URL与Key；四是通过config.yaml显式声明provider、base_url、model_name等参数；五是执行hermes doctor验证连通性，确保Model显示connected。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功安装 Hermes Agent，但启动后无法生成响应或提示模型不可用，则很可能是大模型未正确选择与配置。以下是多种可行的配置路径，覆盖主流服务商与国内常用平台：
一、通过交互式向导快速配置模型
该方式由 Hermes 内置 setup 流程驱动，自动识别可用提供商并引导填写必要参数，适合无 YAML 编辑经验的新手用户。
1、在终端中执行命令：hermes setup
2、当提示 “How would you like to set up Hermes?” 时，选择 Quick setup
3、进入模型提供商选择界面，从列表中选取目标服务（如 OpenAI、OpenRouter、Kimi、Qwen）
4、按提示输入对应 API Key；若为阿里云百炼，需额外指定 Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
5、选择默认模型（如 qwen-turbo 或 deepseek-chat），确认后配置自动写入 ~/.hermes/config.yaml
二、手动编辑 .env 文件注入密钥
此方法绕过向导限制，直接将凭证注入环境变量层，适用于需复用已有密钥或批量部署的场景，且不依赖 CLI 向导状态。
1、使用文本编辑器打开环境变量文件：nano ~/.hermes/.env
2、根据所选服务商，添加唯一一行密钥声明：OPENAI_API_KEY=sk-xxx 或 DASHSCOPE_API_KEY=sk-xxx 或 DEEPSEEK_API_KEY=sk-xxx
3、保存退出后，执行 source ~/.bashrc（Linux/macOS）或重启 PowerShell（Windows）使变量生效
4、运行 hermes doctor 验证 Model 模块是否显示 connected
三、使用 hermes model 命令直连自定义端点
该方式专为兼容 OpenAI 标准协议的国产模型设计，支持手动输入任意 Base URL 与密钥，可接入百炼、DeepSeek、NVIDIA API 等非官方列表服务。
1、在终端中输入：hermes model
2、在提供商菜单中选择 More providers，再选择 Custom endpoint (enter URL manually)
3、输入模型服务地址：https://api.deepseek.com/v1 或 https://dashscope.aliyuncs.com/compatible-mode/v1
4、粘贴对应平台生成的 API Key（输入过程不回显，属正常行为）
5、从返回的模型列表中选择一项（如 deepseek-chat 或 qwen-max），按提示完成确认
四、通过 config.yaml 显式声明模型参数
此方式提供最精细的控制粒度，允许同时定义 provider、base_url、model_name、timeout 等字段，适用于多模型切换或调试特定响应行为。
1、在项目根目录下创建或编辑 config.yaml 文件
2、填入以下结构化配置（以百炼为例）：
model:
provider: openai
base_url: https://dashscope.aliyuncs.com/compatible-mode/v1
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
model_name: qwen-turbo
3、保存后执行 hermes --config config.yaml 启动代理
4、若需切换模型，仅修改 model_name 字段并重启即可，无需重配密钥
五、验证模型连通性与响应质量
配置完成后必须执行诊断命令，确认模型通道真实就绪，避免因网络策略、密钥失效或地域不匹配导致静默失败。
1、运行诊断指令：hermes doctor
2、检查输出中 Model 行是否显示 connected，而非 error 或 timeout
3、若提示 “Invalid API key” 或 “Unauthorized”，请核对密钥是否复制完整、是否含多余空格、是否已过期
4、若提示 “Connection refused”，请确认 base_url 地址格式正确（必须含 https:// 前缀）、地域与实例所在区域一致
