Hermes Agent 接入 OpenRouter 指南：一个 API Key 跑通 200+ 模型

Hermes Agent 接入 OpenRouter 指南：一个 API Key 跑通 200+ 模型

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

如果你不想为每个 AI 提供商分别申请密钥、管理账单，Hermes Agent 搭配 OpenRouter 是一个省心的方案。Hermes Agent 是 Nous Research 开源的命令行 AI 代理，自带终端交互、工具调用和定时任务；OpenRouter 则是模型聚合层，一个密钥就能访问 200 多个模型。两者配合后，你在 Hermes Agent 里用一条命令就能切换模型，不用改任何代码。

这个组合适合什么人

• 想多模型对比的开发者：同一个任务先后跑 Claude、GPT、开源模型，对比输出质量，只维护一个 OpenRouter 账户。
• 远程办公用户：Hermes Agent 支持把代理部署在服务器上，通过 Telegram、Discord 等渠道远程对话，模型由 OpenRouter 统一路由。
• 需要定时自动化的个人用户：配合内置 cron 调度，让代理按天、按周自动执行任务并把结果推送到聊天平台。

第一次上手：安装与初始化

如果还没有 Hermes Agent，先克隆仓库并安装：

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent hermes setup

hermes setup是完整的初始化向导，会引导你配置模型提供商、工具开关等各项设置，比手动改配置文件更适合新手。完成后用hermes启动终端界面，hermes doctor可以检查环境是否有问题。

如何配置 OpenRouter API 密钥

在 OpenRouter 官网注册并拿到密钥后，把它写入 Hermes Agent 的环境文件即可：

echo "OPENROUTER_API_KEY=***" >> ~/.hermes/.env

然后选择模型。有两种方式：

hermes model # 交互式选择提供商和模型

或者在对话中用斜杠命令临时切换，格式是provider:model：

/model openrouter:厂商/模型名

把厂商/模型名换成 OpenRouter 模型页里的完整 ID，例如anthropic/claude-sonnet-4。切换立即生效，不需要重启。

按任务类型选模型

OpenRouter 上模型很多，新手容易挑花眼。按任务类型给一个简单思路：

• 长文档阅读、代码重构：选上下文窗口大、推理强的模型，比如 Claude 系列。
• 日常问答、简单改写：选单价低的中小模型，够用且省钱。
• 批量、高频任务（比如定时摘要）：优先便宜的模型，成本随调用次数放大。

Hermes Agent 会按提供商记录用量，用/usage可以随时查看当前会话消耗了多少 token 和费用，方便你判断哪个模型性价比合适。

三个实际用法

1. 长文档转行动项：把一份冗长的需求文档交给代理，要求"整理成带负责人的行动项清单"。代理读完内容后直接输出 Markdown 表格，你可以让它继续补充优先级排序。
2. 从日志里定位异常：把服务日志目录指给代理，让它统计高频错误并给出可能的原因。Hermes Agent 能在服务器上直接执行命令，适合处理你本机上不存在的大文件。
3. 定时晨报：用内置的 cron 调度写一句自然语言任务，比如"每天早上 9 点汇总昨天的任务进度发到 Telegram"。代理会在无人值守时自动运行，结果推送到你指定的平台。

新手容易卡住的三个地方

• 密钥填了但提示无效：确认写的是~/.hermes/.env，且变量名是OPENROUTER_API_KEY（全大写）。改完后重新打开会话再试。
• 模型 ID 找不到或报错：OpenRouter 的模型 ID 是厂商/模型名两段式，少写厂商前缀会匹配失败。以 OpenRouter 模型页上的 ID 为准。
• 成本超出预期：OpenRouter 按各模型原价计费，代理类任务一轮可能调用多次模型。养成用/usage查看消耗的习惯，批量任务先在小数据集上试跑。

下一步

• 想看 OpenRouter 密钥的读取逻辑，可以翻agent/credential_pool.py，环境变量和密钥池都在那里处理；模型元数据的缓存逻辑在agent/model_metadata.py。
• 仓库的 README（含中文版本README.zh-CN.md）列出了完整的命令清单和文档目录，hermes setup --help也能看到向导的所有选项。
• 如果后续想扩展到消息网关、定时任务或工具系统，README 中的文档章节有对应专题，比零散搜索更高效。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent