Configurer Hermes Agent avec OmniaKey : endpoint OpenAI-compatible

Mis à jour le 30 octobre 2026 : quatre erreurs de configuration courantes de Hermes indiquent désormais le symptôme, la cause et la solution, d'après la documentation officielle de Hermes Agent.

Pour configurer Hermes Agent API, ajoutez un endpoint personnalisé compatible avec OpenAI. Hermes Agent de Nous Research peut ensuite passer de Claude à GPT, Gemini ou Grok en changeant l'ID du modèle.

Méthode rapide : hermes model

hermes model

Choisissez Custom endpoint (self-hosted / VLLM / etc.), puis saisissez :

• Base URL : https://api.omniakey.com/v1
• API key : votre clé OmniaKey
• Model : par exemple claude-opus-4-8

Modifier config.yaml

Pour une configuration persistante avec plusieurs modèles, utilisez ~/.hermes/config.yaml :

model:
  provider: custom
  base_url: https://api.omniakey.com/v1
  api_key: your-omniakey-api-key
  default: claude-opus-4-8
models:
  - claude-opus-4-8
  - gpt-5.5
  - gemini-3.1-pro-preview
  - grok-4.5

provider: custom demande à Hermes d'appeler directement votre endpoint. models: alimente le sélecteur /model; redémarrez Hermes après la modification, puis passez de claude-opus-4-8 à gpt-5.5, gemini-3.1-pro-preview ou grok-4.5 sans quitter la session.

Une clé, quatre familles

OmniaKey choisit le modèle par ID sur son endpoint compatible OpenAI. Un seul endpoint couvre les quatre familles, avec une facturation au token depuis un solde prépayé. L'ID configuré est celui qui s'exécute, sans fallback silencieux vers un modèle « équivalent ». Le catalogue de modèles liste tous les ids que vous pouvez définir, et les tarifs donnent le prix par token de chacun. La même clé fonctionne dans d'autres agents ; voir les guides configurer OpenClaw, clé API personnalisée dans Cline et configurer Claude Code.

Erreurs de configuration courantes

Ces quatre cas reviennent souvent quand Hermes pointe vers un endpoint personnalisé. La cause et la solution viennent de la documentation des fournisseurs de Hermes et de la référence de configuration.

/model ne propose pas l'endpoint personnalisé

Symptôme : vous tapez /model dans une session ouverte et OmniaKey n'apparaît pas dans la liste.

Cause : /model dans une session ne bascule qu'entre les fournisseurs déjà configurés. Il ne peut pas ajouter de fournisseur, lancer un OAuth ni demander une clé API.

Solution : quittez la session, lancez hermes model dans le terminal, configurez l'endpoint personnalisé, puis démarrez une nouvelle session.

Une clé dans .env est ignorée et les requêtes partent vers un autre fournisseur

Symptôme : vous mettez la base URL ou la clé dans ~/.hermes/.env, et Hermes appelle toujours un fournisseur intégré.

Cause : LLM_MODEL dans .env a été supprimé, config.yaml est la seule source pour le modèle et l'endpoint, et OPENAI_BASE_URL ne compte que pour le fournisseur openai-api.

Solution : mettez base_url et api_key dans le bloc model: de ~/.hermes/config.yaml, ou pointez key_env vers la variable qui contient la clé. Une fois base_url défini, Hermes appelle cet endpoint directement et s'authentifie avec api_key ou OPENAI_API_KEY.

Hermes ne démarre pas avec provider: main

Symptôme : le démarrage échoue, ou le sélecteur de modèles reste vide, après avoir mis provider: main dans le bloc model: de premier niveau.

Cause : main signifie « utilise le fournisseur de mon agent principal » et ne vaut que dans auxiliary:, compression: ou une entrée de repli.

Solution : mettez provider: custom dans model:, à côté de la base_url et de la clé OmniaKey.

/model custom choisit un autre modèle

Symptôme : /model custom prend un modèle que vous n'avez pas demandé, ou renvoie une erreur.

Cause : /model custom sans nom interroge l'API /models de l'endpoint et ne choisit automatiquement que si un seul modèle est chargé ; OmniaKey en sert plusieurs.

Solution : nommez le modèle, par exemple /model custom:claude-opus-4-8.

Questions fréquentes

Comment connecter Hermes Agent à OmniaKey ?

Lancez hermes model, choisissez Custom endpoint (self-hosted / VLLM / etc.) et saisissez https://api.omniakey.com/v1 comme base URL, votre clé OmniaKey et un ID de modèle comme claude-opus-4-8. Les mêmes trois valeurs dans ~/.hermes/config.yaml suffisent si vous préférez éditer le fichier.

Pourquoi Hermes renvoie-t-il une erreur 404 avec ma base URL OmniaKey ?

La base URL doit s'arrêter à /v1. Hermes ajoute /chat/completions lui-même, donc une URL qui contient déjà ce chemin, ou avec un slash final, est la cause habituelle du 404.

Une seule clé OmniaKey suffit-elle pour Claude, GPT, Gemini et Grok ?

Oui. OmniaKey choisit le modèle par ID sur son endpoint compatible OpenAI, donc un seul endpoint couvre les quatre familles : vous changez l'ID, pas le bloc de fournisseur. Ajoutez les ID voulus à la liste models: et ils apparaissent dans le sélecteur /model.

Comment changer de modèle en cours de session ?

Tapez /model custom:<model ID>, par exemple /model custom:gpt-5.5. Redémarrez Hermes une fois après avoir modifié la liste models: : le sélecteur et /model voient alors les nouveaux ID.

Sources vérifiées

• Nous Research : fournisseurs de LLM et de modèles
• Nous Research : configuration de Hermes Agent

Le guide des agents de programmation couvre les autres outils.