Paramètres principaux
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
Exigences supplémentaires
- Le Model ID sélectionné provient du fournisseur compatible
- 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)
- Linux / macOS / WSL2
- Windows PowerShell
Hermes recommande l’installateur Desktop sur macOS et Windows. Téléchargez Hermes Desktop et exécutez l’installateur correspondant à votre système.
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
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.Configuration
- Interactive setup
- Fichiers de configuration
1
Exécuter le sélecteur de modèle
Si un chat Hermes est ouvert, quittez d’abord la session. Exécutez ensuite :
2
Choisir Custom endpoint
Sélectionnez Custom endpoint (self-hosted / VLLM / etc.) dans la liste des fournisseurs.
3
Saisir la configuration BetterToken
Saisissez :
- Base URL:
https://bettertoken.ai/v1 - API Key : votre BetterToken API Key
- Model : un model ID d’un fournisseur compatible copié depuis le model plaza
4
Démarrer Hermes Agent
hermes si vous préférez l’interface classique du terminal.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.https://bettertoken.ai/v1, votre BetterToken API Key et un model ID d’un fournisseur compatible.
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écutezhermes 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
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/completionsdans ce champ. - Si Hermes indique que le modèle n’existe pas, vérifiez que Model est un model ID d’un fournisseur compatible du model plaza.
- Si l’authentification échoue, vérifiez les espaces copiés et confirmez que le Model ID sélectionné provient du fournisseur compatible.
- 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-Agentsupplé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.
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
Configuration avancée
Fournisseurs compatibles
Les états concernent la méthode de configuration de BetterToken décrite sur cette page.
Signification des méthodes de configuration
Signification des méthodes de configuration
- Configuration manuelle : saisissez l’API Key, la Base URL et le Model.
- Non compatible : aucune méthode de connexion directe vérifiée n’est disponible pour le moment.
Détails techniques
Protocole, endpoint et champs internes du fournisseur
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.