Configuration de TokenHub de l'agent Hermes

Installez Hermes Agent, sélectionnez le fournisseur Tencent TokenHub intégré et validez un modèle compatible.

Qu’est-ce que l’agent Hermès ?

Hermes Agent est un agent personnel open source de Nous Research avec une mémoire persistante, une utilisation des outils et des compétences.

Cette configuration de l'agent Hermes utilise son fournisseur Tencent TokenHub intégré et stocke TOKENHUB_API_KEY dans le fichier d'environnement documenté. Sélectionnez un modèle disponible dans le catalogue en direct avant de tester une tâche sûre. Hermes Agent peut combiner une mémoire persistante, des compétences, des outils et différentes interfaces utilisateur, mais ces interfaces ne remplacent pas la configuration du fournisseur sous-jacent. Installez à partir du projet officiel Nous Research, protégez le fichier d'environnement et évaluez le succès de l'outil, les besoins en contexte, la latence et les coûts d'exploitation sur une tâche réelle mais à faible risque.

Hermes Agent peut acheminer ses requêtes de modèle via la passerelle API OpenAI compatible de TokenHub. Gardez l’installation officielle, puis remplacez seulement la clé API, la Base URL et l’ID du modèle.

L’endpoint TokenHub utilisé dans ce guide est https://us-api.tokenhub.com/v1/chat/completions.

Quand l’utiliser

Commencez dans un petit dépôt ou un projet de test. Demandez d’abord à l’outil de lire des fichiers, expliquer le code ou proposer un plan, puis activez les modifications.

Installer ou ouvrir l’outil

Suivez la documentation officielle Hermes Agent pour installer ou ouvrir l’outil. Si les menus changent, suivez la version actuelle de la documentation.

Pour les outils CLI, vérifiez que l’exécutable fonctionne avant d’ajouter les identifiants TokenHub :

hermes --version

Préparer les identifiants TokenHub

Créez une clé API TokenHub et choisissez dans la liste des modèles TokenHub un modèle adapté à cet outil.

export TOKENHUB_API_KEY="sk-..."

Conservez la clé dans votre shell local, le stockage secret de l’IDE ou le champ API key sécurisé de l’outil. Ne la commitez pas dans le dépôt.

Configurer le fournisseur TokenHub

Dans les réglages Models, Providers, API Keys ou OpenAI Compatible, renseignez les valeurs ci-dessous.

Valeurs du provider

ChampValeur
FournisseurOpenAI Compatible ou Custom
Base URLhttps://us-api.tokenhub.com/v1
API KeyLa valeur de TOKENHUB_API_KEY
Modèlegpt-4.1 ou un autre model ID TokenHub

Emplacements des réglages

ChampValeur
Secret~/.hermes/.env
Provider and model config~/.hermes/config.yaml
Named custom providertokenhub-custom
TOKENHUB_API_KEY=sk-...
custom_providers:
  - name: tokenhub-custom
    base_url: '__API_BASE_URL__/v1'
    key_env: TOKENHUB_API_KEY
    api_mode: chat_completions

model:
  provider: 'custom:tokenhub-custom'
  default: 'gpt-4.1'

This follows Hermes' current named custom provider schema: base_url is the OpenAI-compatible Base URL, key_env reads the secret without writing it into YAML, and api_mode: chat_completions selects /v1/chat/completions.

Always keep the custom: prefix. Hermes treats bare tokenhub as a built-in provider alias; custom:tokenhub-custom unambiguously selects this self-hosted endpoint.

/model custom:tokenhub-custom:gpt-4.1
hermes chat

Hermes stores the named custom provider, Base URL, API mode, and default model in ~/.hermes/config.yaml. The API key remains in ~/.hermes/.env. You can also run hermes model, select Custom Endpoint, and enter the same values interactively.

Si l’outil sépare chat, edit, apply et fast models, utilisez le même modèle TokenHub pour le premier test. Séparez-les ensuite selon le coût, la latence et la capacité de raisonnement.

Variables temporaires pour le diagnostic

Utilisez les variables temporaires seulement pour vérifier la clé, le réseau et le nom du modèle. Après validation, déplacez les mêmes valeurs dans la configuration persistante ci-dessus.

export TOKENHUB_API_KEY="sk-..."

Vérifier la connexion

Testez d’abord avec une consigne en lecture seule pour confirmer que le modèle lit le contexte sans modifier les fichiers. Testez ensuite les actions d’édition ou d’agent.

Lis le README du projet et résume-le en trois phrases. Ne modifie aucun fichier.

Après un prompt réussi, consultez les logs TokenHub pour vérifier le modèle, l’endpoint, les tokens consommés et le groupe de facturation.

Dépannage

SymptômeCorrection
401 ou échec d’authentificationVérifiez que TOKENHUB_API_KEY est valide et enregistré dans le même terminal, IDE ou profil client.
404 ou modèle introuvableUtilisez un model ID présent dans votre espace TokenHub et compatible avec le protocole choisi.
Endpoint incorrectGardez exactement la Base URL indiquée ci-dessus. Les outils compatibles OpenAI demandent généralement /v1; les outils compatibles Claude non.
TimeoutVérifiez le réseau vers https://us-api.tokenhub.com, les paramètres proxy et l’allowlist de l’espace de travail.
L’outil utilise un autre modèleRevérifiez tous les emplacements chat, edit, apply, fast ou autocomplete.

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ sur la configuration de l'agent Hermes

Quel fournisseur dois-je sélectionner dans Hermes Agent ?

Sélectionnez Tencent TokenHub dans le modèle Hermes. Son identifiant de fournisseur documenté est tencent-tokenhub, avec tokenhub comme alias.

Où doit aller la clé API TokenHub ?

Stockez TOKENHUB_API_KEY=... dans ~/.hermes/.env, qui est le fichier d'informations d'identification des documents Hermes Agent pour ce fournisseur.

Pourquoi ne devrais-je pas coder en dur un modèle à partir de ce guide ?

Le catalogue Tencent TokenHub est en ligne et les modèles disponibles peuvent changer. Choisissez un modèle présenté par le modèle Hermes ou entrez un identifiant exact actuellement disponible.

Quel est le lien entre Hermes Agent et Nous Research ?

Hermes Agent est un projet d'agent open source de Nous Research. Les recherches de financement ou de valorisation d’entreprises sortent de ce guide d’intégration.

Comment dois-je comparer Hermes Agent avec OpenClaw ?

Utilisez la même tâche réelle pour comparer le déploiement, la mémoire, les compétences, les intégrations de canaux, la fiabilité des outils, le coût du modèle et la complexité de la maintenance.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-04。