Configurer Hermes Agent : clé API, Base URL et modèles

Pour connecter Hermes Agent à BetterToken, préparez une API Key, saisissez la Base URL ci-dessous et choisissez un Model ID actuel dans le model plaza.

Paramètres principaux

Champ	Valeur
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Un Model ID actuel du model plaza

Prérequis

• La version actuelle de l’outil est installée
• Une BetterToken API Key : inscrivez-vous pour en obtenir une
• Un Model ID du model plaza

Inscrivez-vous et obtenez une BetterToken API Key→

Vous avez déjà un compte ? Connectez-vous, rechargez votre solde, puis créez une clé dans la console.

Exigences supplémentaires

• Copiez le Model ID exact depuis la model plaza.
• macOS, Linux, Windows 10/11 ou WSL2
• Un modèle doté d’une fenêtre de contexte d’au moins 64K pour utiliser les outils

Installation

Installer Hermes Agent

Desktop (macOS / Windows)

Hermes recommande l’installateur Desktop sur macOS et Windows. Téléchargez Hermes Desktop et exécutez l’installateur correspondant à votre système.

Linux / macOS / WSL2

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell

Hermes Agent prend en charge nativement Windows 10 et 11. Exécutez ceci dans PowerShell ou Windows Terminal :

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Aucun droit administrateur n’est requis. Ouvrez une nouvelle fenêtre PowerShell après l’installation.

hermes --version
hermes doctor

WSL2 reste compatible, mais il est facultatif. Utilisez-le si vous avez besoin d’un environnement Linux ou du terminal intégré au Web Dashboard.

Référence rapide des fonctionnalités

Fonctionnalité	Utilité
Terminal UI	Discutez directement avec l’agent dans votre terminal
Skills	Enregistrez des workflows réutilisables pour les tâches répétées
MCP	Connectez des capacités d’outils locales ou distantes
Scheduled tasks	Exécutez des tâches planifiées et des workflows récurrents
Subagents	Répartissez un travail complexe entre des agents spécialisés
Message gateway	Connectez l’agent à davantage de points d’entrée de messagerie

Configuration manuelle

Utilisez la configuration interactive de modèle Hermes Agent comme méthode principale. Modifiez directement les fichiers de configuration uniquement si vous avez besoin d’une configuration manuelle.

Champ	Valeur
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Model	Un Model ID actuel du model plaza

Configuration

Interactive setup

Exécuter le sélecteur de modèle

Si un chat Hermes est ouvert, quittez d’abord la session. Exécutez ensuite :

hermes model

Choisir Custom endpoint

Sélectionnez Custom endpoint (self-hosted / VLLM / etc.) dans la liste des fournisseurs.

Saisir la configuration BetterToken

Saisissez :

• Base URL: https://bettertoken.ai/v1
• API Key : votre BetterToken API Key
• Model : un model ID disponible copié depuis le model plaza

Si Hermes demande le mode d’API, choisissez Chat Completions. Pour les outils de l’agent, utilisez un modèle avec au moins 64K de contexte.

Démarrer Hermes Agent

hermes --tui

Exécutez hermes si vous préférez l’interface classique du terminal.

Fichiers de configuration

Ajoutez le fournisseur custom dans ~/.hermes/config.yaml :

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: "https://bettertoken.ai/v1"

Stockez séparément la BetterToken API Key dans ~/.hermes/.env :

OPENAI_API_KEY=YOUR_API_KEY

Remplacez YOUR_MODEL_ID par un model ID disponible du model plaza et YOUR_API_KEY par votre BetterToken API Key. Sous Windows natif, ces fichiers se trouvent dans %LOCALAPPDATA%\hermes\.

Migrer depuis OpenClaw

Si vous utilisez déjà OpenClaw, vérifiez d’abord si votre version actuelle de Hermes Agent fournit la commande de migration. Exécutez un essai à blanc avant toute modification.

hermes claw migrate --dry-run

Après avoir confirmé la sortie, exécutez la migration :

hermes claw migrate

Après la migration, vérifiez encore la Base URL, l’API Key et le model ID de Hermes Agent. Ils doivent correspondre à https://bettertoken.ai/v1, votre BetterToken API Key et un model ID disponible.

Vérifier la connexion

Démarrez Hermes Agent et envoyez ce court prompt de test :

Reply with HERMES_OK only. Do not use tools.

Si la réponse est exactement HERMES_OK, la connexion fonctionne.

Changer de modèle

En dehors d’une session, exécutez hermes model. Dans un chat actif, utilisez /model pour changer de fournisseur ou de modèle déjà configuré. Choisissez le Model ID exact du model plaza.

Erreurs courantes

Erreur	Vérifications
401 ou Unauthorized	Vérifiez la BetterToken API Key et supprimez les espaces initiaux ou finaux.
404	Vérifiez la Base URL et n’ajoutez pas de chemin d’endpoint spécifique.
model not found	Copiez un Model ID actuel depuis le model plaza.
Les modifications ne sont pas appliquées	Enregistrez la configuration et redémarrez complètement l’outil.

Dépannage

• Si les Request échouent ou ne renvoient aucune réponse, vérifiez que la Base URL est exactement https://bettertoken.ai/v1. N’ajoutez pas /chat/completions dans ce champ.
• Si Hermes indique que le modèle n’existe pas, vérifiez que Model est un model ID disponible du model plaza.
• Copiez le Model ID exact depuis la model plaza.
• Si Hermes utilise toujours l’ancien modèle après une modification, quittez la session Hermes Agent actuelle et exécutez à nouveau hermes.
• BetterToken ne nécessite généralement pas de User-Agent supplémentaire ni d’en-têtes personnalisés. Ajoutez des en-têtes uniquement si votre passerelle personnalisée, le routage de locataire, la couche d’observabilité ou de cache les exige explicitement.

Pour une passerelle qui exige des en-têtes d’authentification supplémentaires, Hermes prend en charge extra_headers sous providers.<provider-name> dans config.yaml. Suivez la configuration des fournisseurs nommés pour les noms d’en-têtes requis et gardez les identifiants confidentiels.

Ne validez pas d’API Key réelle dans votre dépôt. Pour une configuration partagée avec l’équipe, privilégiez les variables d’environnement ou une configuration locale.

FAQ associée

• MCP, API Key et Base URL

• Que sont model_provider, base_url et wire_api ?

• Configurer une API OpenAI compatible dans Cline

• Guide de configuration OpenClaw BetterToken

• Comparer tous les outils pris en charge

• Erreurs API, codes de statut et limites de débit

Détails techniques

Protocole, endpoint et champs internes du fournisseur

Cette configuration utilise https://bettertoken.ai/v1. L’outil ajoute le chemin d’endpoint OpenAI compatible. N’ajoutez pas /chat/completions ni /responses sauf si un champ spécifique l’exige explicitement.

Références officielles de Hermes

• Installation
• Plateformes prises en charge
• Fournisseurs de LLM et de modèles