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 ou Windows WSL2
Installation
Installer Hermes Agent
- macOS / Linux / WSL2
- Windows
Référence rapide des fonctionnalités
Configuration manuelle
Utilisez la configuration interactive de modèle Hermes Agent comme méthode principale. Les commandes et les variables d’environnement restent disponibles comme alternatives.Configuration
- Interactive setup
- CLI config
- Environment variables
1
Exécuter le sélecteur de modèle
2
Choisir le fournisseur OpenAI ou OpenAI Compatible
Sélectionnez OpenAI ou OpenAI Compatible dans la liste des fournisseurs.
3
Saisir la configuration BetterToken
Saisissez :
- Base URL:
https://www.bettertoken.ai/v1 - API Key : votre BetterToken API Key
- Model : un model ID d’un fournisseur compatible copié depuis le model plaza
4
Redémarrer Hermes Agent
Après avoir mis à jour la configuration, quittez la session Hermes Agent actuelle et redémarrez-la.
5
Démarrer Hermes Agent
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://www.bettertoken.ai/v1, votre BetterToken API Key et un model ID d’un fournisseur compatible.
Vérifier la connexion
Envoyez un court prompt de test. Si l’outil renvoie une réponse sans erreur d’authentification ni erreur de Model ID, la connexion fonctionne. Redémarrez complètement l’outil après avoir modifié sa configuration.Changer de modèle
Ouvrez le sélecteur de modèle ou modifiez le champModel dans la configuration. Utilisez le Model ID exact du model plaza, puis redémarrez la session actuelle.
Erreurs courantes
Dépannage
- Si les Request échouent ou ne renvoient aucune réponse, vérifiez que la Base URL est exactement
https://www.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://www.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.