Hermes Agent 接入 OpenRouter 指南:一把密钥切换 200+ 模型
【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent
Hermes Agent 是一个定位"与你共同成长"的 AI 代理工具,其中一项很实用的能力是接入模型聚合平台 OpenRouter:用一把 API 密钥访问 200 多家模型,涵盖 Anthropic、OpenAI、Google 等厂商,做不同任务时可以按需切换模型。本文按"先想清楚 → 准备好 → 跑起来 → 用起来"的路径把这件事讲一遍,没有用过这类工具的读者也能直接照做。
先想清楚:要不要做统一接入
只用一家供应商的一个模型时,直接申请那家的 API 密钥即可。问题在于多数人同时用多个模型:长文本任务交给 Claude,写代码用 GPT 系列,生成图片用 DALL-E。这时要为每家单独注册、单独保管密钥、单独适配调用接口,换一个模型往往要改配置甚至改代码。
OpenRouter 把 200 多家不同厂商的模型聚合在一个统一接口后面,接上之后不必关心模型归属哪家,只需要提供模型名。附带的好处是成本控制:不同模型价格不同,简单任务可以选择便宜的那一档。
准备好:一把密钥与一个配置文件
准备工作只有两步,都在 Hermes Agent 的安装环境里完成。
第一步,在 OpenRouter 官网注册并拿到 API 密钥。第二步,在终端执行安装向导,按提示把密钥粘贴进去:
hermes setup密钥会被写入本地的 cli-config.yaml 并保存更新。如果习惯直接管理配置文件,也可以手动编辑 cli-config.yaml,把密钥加进去即可。
跑起来:两种模型调用方式
密钥配置完成后,有两种最常用的调用方式。
第一种是在命令行里直接指定模型:
hermes run --model anthropic/claude-opus-4.6第二种是在配置文件中设置默认模型,之后运行就不用每次都带模型参数。后续想换模型,只改这个默认值即可,不需要动代码。如果是在程序里调用,也可以传模型名动态选择,方便按任务自动切换。
用起来:按任务选模型
统一接入的实际价值是"什么活儿用什么工具"。几个常见组合供参考:
- 内容创作:用 GPT 系列生成文章、故事或社媒文案
- 代码开发:选代码能力强的模型生成代码片段、辅助重构
- 数据分析:让模型快速梳理大量数据并输出结论
- 创意设计:用 DALL-E 等模型产出图片
养成的习惯建议是:任务重(长文本、复杂推理)时选顶级模型,任务轻(摘要、格式化、翻译)时降到便宜档,长期使用下来差距会很明显。
下一步
本地部署克隆仓库即可开始:
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考