在 Hermes Agent 中使用 OminiGate

Nous Research 的自进化 Agent 可以对接任意 OpenAI 兼容端点。配上两个环境变量即可指向 OminiGate，原有技能、记忆、工作流保持不变。

Hermes Agent

概览

Hermes Agent 是 Nous Research 推出的自主 Agent，具备持久记忆与自进化技能系统，支持 OpenRouter、OpenAI，以及任意遵循 OpenAI chat-completions 协议的端点。

OminiGate 在 /v1/chat/completions 上提供的正是这套协议。当 provider = "custom" 或显式设置 base_url 时，Hermes 会通过 OPENAI_BASE_URL 与 OPENAI_API_KEY 发起请求 —— 接入 OminiGate 只需这些。

  • Hermes 的技能、工具、MCP 集成一概不变。
  • 通过 hermes chat --model [slug] 可以在对话级别切换模型。
  • 会话记忆、技能、SQLite 状态都保存在本地，OminiGate 只负责模型调用。

前置条件

安装 Hermes Agent 并准备一把 OminiGate API Key。

1. 安装 Hermes

Hermes 只推荐一种安装方式 —— 官方 install 脚本。会自动适配 Linux、macOS、WSL2、Android (Termux) 的平台差异。安装完成后执行 source ~/.bashrc（或 ~/.zshrc）刷新 PATH。

shell
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

2. 获取 OminiGate API Key

到 Dashboard 创建 Key。Hermes 会把 provider 配置（含 key）写入 ~/.hermes/config.yaml。

打开 API Keys→

配置 Hermes

一条命令搞定全部。hermes model 会引导你选 provider、填 base URL 与 key、挑默认模型，并把结果保存到 ~/.hermes/config.yaml。

shell
# One command sets the provider, base URL, key, and default model
hermes model

运行 hermes model 选 provider 时，请选择 "Custom endpoint (enter URL manually)"。Hermes 会自动验证 base URL，列出 OminiGate 上的全部模型，并把 custom provider 条目保存到 ~/.hermes/config.yaml。

向导实际输出

运行 hermes model 选择 "Custom endpoint" 后的真实输出 —— Hermes 会自动验证 URL、拉 /v1/models 列表，并让你挑选默认模型。

terminal
~ hermes model
API base URL [e.g. https://api.example.com/v1]: https://api.ominigate.ai/v1
API key [sk-omg-8...]:
Verified endpoint via https://api.ominigate.ai/v1/models (295 model(s) visible)
  Available models:
    1. qwen/qwen3.6-27b
    2. openai/gpt-5.5-pro
    3. openai/gpt-5.5
    4. deepseek/deepseek-v4-pro
    5. deepseek/deepseek-v4-flash
    6. xiaomi/mimo-v2.5-pro
    7. xiaomi/mimo-v2.5
    8. moonshotai/kimi-k2.6
    9. anthropic/claude-opus-4.7
    10. anthropic/claude-opus-4.6-fast
    11. z-ai/glm-5.1
    ...
  Select model [1-295] or type name: 5
Context length in tokens [leave blank for auto-detect]:
Display name [Api.ominigate.ai]: OminiGate
Default model set to: deepseek/deepseek-v4-flash (via https://api.ominigate.ai/v1)
  💾 Saved to custom providers as "OminiGate" (edit in config.yaml)

运行 Hermes

启动一次对话 —— Hermes 会把每次工具调用的往返都经由 OminiGate：

shell
hermes chat "Summarize the latest commit log and draft release notes"

单次运行切换不同模型：

shell
hermes chat --model anthropic/claude-opus-4.6 "Refactor hermes/skills/web.py"

推荐模型

Hermes Agent 使用 OpenAI chat-completions 协议，OminiGate 上所有该协议的模型都可以直接调用。下面这四个作为起手足够稳妥。

openai/gpt-5.4-pro

OpenAI 旗舰 —— 多步 Agent 计划的默认基线。

anthropic/claude-opus-4.6

Anthropic 顶级档位，长上下文推理场景首选。

anthropic/claude-sonnet-4.6

Anthropic Sonnet —— 速度与质量平衡，适合大多数 Agent 任务。

google/gemini-3.1-pro-preview

Gemini 3 Pro —— 擅长多模态输入与工具调用规划。

完整模型列表： /models.

常见问题

运行 hermes model 后被引导去登录 ChatGPT —— 怎么回事？

hermes model 是 provider 配置向导。选 OpenAI Codex 会触发 ChatGPT OAuth，流量会走你的 Codex 账号而不是 OminiGate。请重新运行 hermes model，选择 "Custom endpoint (enter URL manually)"，然后填入 https://api.ominigate.ai/v1 和你的 sk-omg- key。

Hermes 依然在调用其它 provider（例如 OpenRouter），而不是 OminiGate。

之前保存的另一个 provider 还在作为 default 生效。重新运行 hermes model，选择你的 OminiGate 条目即可。Hermes 会把每个 custom provider 存成命名条目（在 ~/.hermes/config.yaml 中），随时可以切换。

curl 里 Key 可用，Hermes 却报 invalid_api_key。

每个 custom provider 的 key 都保存在 ~/.hermes/config.yaml 该条目内。重新运行 hermes model，选你的 OminiGate 条目（或 "Custom endpoint" 重新开始），按提示重新输入 key 即可。

Hermes 的视觉/抽取工具会调用哪些模型？

若未单独设置任务级 override，Hermes 的辅助工具（vision、网页抽取）会复用当前 default provider 的 base URL 与 key。只要 default 是 OminiGate 那个条目，它们就会自动经由 OminiGate —— 别忘了挑一个对应模态的模型。

下一步

查看完整 API 参考，或浏览更多可通过 Hermes 调用的模型。

API 参考浏览模型