需完成OpenRouter密钥配置才能在Hermes Agent中调用其200+模型服务，包括：一、登录openrouter.ai/keys创建并保存API密钥；二、通过hermes setup命令注入密钥并验证；三、执行hermes model set设置默认模型；四、运行时用--model参数动态切换；五、用hermes health check验证连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Hermes Agent中快速启用200多个AI模型，但尚未完成OpenRouter服务的接入配置，则可能是由于API密钥未设置或模型路由未正确声明。以下是实现零门槛接入的具体操作路径：
一、获取OpenRouter API密钥
OpenRouter平台要求用户通过唯一API密钥认证身份，该密钥是后续所有模型调用的身份凭证和计费依据。密钥一旦生成即与账户绑定，需妥善保管且不可重复获取相同值。
1、访问 https://openrouter.ai/keys 并登录您的OpenRouter账户。
2、点击页面右上角“Create new key”按钮。
3、在弹出窗口中为密钥填写描述性名称（例如：hermes-prod-2026），然后点击“Create Key”。
4、页面将显示新生成的密钥字符串，立即复制并保存至安全位置；关闭页面后将无法再次查看明文密钥。
二、通过CLI命令注入密钥
hermes setup 命令会引导完成密钥写入与基础环境校验，该流程自动识别当前用户配置目录并更新cli-config.yaml，避免手动编辑导致格式错误。
1、在终端中执行 hermes setup。
2、当提示“Enter your OpenRouter API key”时，粘贴上一步复制的密钥字符串。
3、按回车确认，系统将自动验证密钥有效性并写入配置文件。
4、若出现“✅ OpenRouter key saved successfully”提示，表示注入完成。
三、设置默认OpenRouter模型
Hermes Agent通过model标识符精确路由至OpenRouter托管的特定模型，标识符格式为 provider:model-id，其中openrouter前缀声明使用OpenRouter通道。
1、执行命令 hermes model set openrouter:anthropic/claude-3.5-sonnet。
2、可替换为其他有效模型ID，例如 openrouter:google/gemini-2.0-flash 或 openrouter:mistralai/mistral-7b-instruct。
3、执行后终端返回“Default model updated”，表明后续所有未显式指定模型的调用均将使用该模型。
四、运行时动态切换模型
无需修改任何配置文件或重启进程，可在单次任务中覆盖默认模型设置，适用于多阶段任务中对不同模型能力的分步调用需求。
1、在执行任务命令时添加 --model 参数，例如：hermes run --model openrouter:deepseek/deepseek-coder。
2、也可结合工具链使用，如：hermes tool search --model openrouter:perplexity/llama-3.1-sonar-large。
3、该参数优先级高于配置文件中的default_model字段，执行完毕后不影响全局默认设置。
五、验证模型连通性
使用内置健康检查命令触发一次最小化推理请求，直接验证OpenRouter通道是否可用、密钥是否有效、模型标识是否被正确解析。
1、运行命令 hermes health check --provider openrouter。
2、观察输出中是否包含“Provider: openrouter”、“Status: OK”及响应延迟数值。
3、若返回“HTTP 401 Unauthorized”，说明密钥无效或已过期；若返回“Model not found”，说明模型ID拼写错误或该模型当前在OpenRouter中不可用。
