TokenLab

Outils de code

Configuration du fournisseur TokenLab

Configurer TokenLab comme fournisseur personnalisé dans OpenClaw en utilisant les routes compatibles OpenAI, Responses, Anthropic et Gemini

Confier la configuration à mon agent

Copiez cette tâche dans un agent déjà opérationnel sur votre ordinateur :

Lis ce guide et aide-moi à connecter OpenClaw à TokenLab :
https://tokenlab.sh/docs/fr/guides/tokenlab-provider
Vérifie d’abord ma version installée et la configuration active.
Préserve les comptes, les fournisseurs, les permissions et les autres réglages existants.
Sauvegarde les fichiers locaux et présente les modifications proposées.
Laisse-moi saisir localement les clés API nécessaires ; ne les demande, ne les affiche et ne les colle jamais dans le chat.
Vérifie d’abord que la configuration se charge correctement.
Explique séparément le coût de tout test utilisant une requête payante avant de l’exécuter.

Ce guide s'adresse aux utilisateurs d'OpenClaw auto-hébergé qui souhaitent connecter TokenLab comme fournisseur IA.

Recommandé : installer le plugin

Facultatif : installez le plugin publié 0.1.0. Fournissez TOKENLAB_API_KEY dans l’environnement Gateway décrit ci-dessous et sélectionnez le modèle pour la session uniquement. L’assistant modifie le modèle par défaut ; ce guide n’exécute donc pas openclaw onboard. Conservez les plugins et permissions existants et vérifiez le chargement et la liste des modèles avant tout appel.

Examinez les capacités demandées par l’installateur et suivez ses confirmations. N’accordez pas de permissions sans rapport et ne modifiez pas celles des plugins existants.

openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab
/model tokenlab/claude-sonnet-5 -s
/model default -s

npm · GitHub

Configuration manuelle du fournisseur

Utilisez les entrées models.providers ci-dessous uniquement si vous avez explicitement besoin de routes distinctes pour Responses API, Claude native, Gemini native ou MiniMax native.

Si vous choisissez la configuration manuelle, la configuration de tokenlab seule suffit. Ajoutez les autres fournisseurs uniquement lorsque vous avez explicitement besoin du comportement Responses API, Claude natif, Gemini natif, ou MiniMax natif.

FournisseurOpenClaw apiIdéal pourbaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen et la plupart des appels compatibles OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesWorkflows OpenAI Responses qui s'attendent à la sémantique /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesAPI Messages native de Claudehttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiFormat API Gemini natifhttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesRoutage MiniMax natifhttps://api.tokenlab.sh

N'utilisez le suffixe /v1 que pour openai-completions et openai-responses.

Les fournisseurs natifs tels que anthropic-messages et google-generative-ai doivent utiliser https://api.tokenlab.sh sans /v1, sinon OpenClaw peut construire un chemin upstream incorrect.

Prérequis

  • Une instance OpenClaw auto-hébergée
  • OpenClaw 2026.9.4 nécessite Node.js >=24.16.0 <25 || >=26.1.0 (versions requises). Pour une autre version d'OpenClaw, vérifiez ses exigences.
  • Une clé API TokenLab — Get one here

Configuration

Modifiez votre configuration OpenClaw :

  • Auto-hébergé : ~/.openclaw/openclaw.json

Ajoutez les fournisseurs TokenLab sous models.providers :

Utilisez le même profil, OPENCLAW_STATE_DIR et OPENCLAW_CONFIG_PATH que la passerelle active, puis sauvegardez sa configuration. Placez TOKENLAB_API_KEY dans son .env global de confiance ou son environnement de service. Un export du terminal ou un .env de projet peut être invisible en arrière-plan. Voir l’environnement.

Sauvegardez la configuration active. Ajoutez uniquement l’entrée TokenLab et conservez les fournisseurs, comptes, modèle par défaut et permissions existants. Si le nom est déjà utilisé, choisissez-en un autre et adaptez les commandes. Pour annuler, retirez uniquement votre entrée ou restaurez sa sauvegarde précédente.

{
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
          { id: "deepseek-reasoner", name: "DeepSeek Reasoner" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "claude-sonnet-5", name: "Claude Sonnet 5" },
          { id: "claude-opus-5", name: "Claude Opus 5" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
          { id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "${TOKENLAB_API_KEY}",
        models: [
          { id: "minimax-m3", name: "MiniMax M3" }
        ]
      }
    }
  }
}

Les 5 fournisseurs utilisent la même clé API. Vous n'avez besoin que d'un seul compte TokenLab.

Les tableaux models ci‑dessus montrent uniquement des exemples courants. Ajoutez d'autres IDs de modèle pour chaque fournisseur selon vos besoins.

Utilisation des modèles

OpenClaw référence toujours les modèles avec le format provider/model :

Avec OpenClaw 2026.9.4, sélectionnez le modèle uniquement pour la session actuelle avec -s. Conservez agents.defaults.model, les valeurs par défaut de l’agent et les permissions. /model default -s rétablit le modèle configuré par défaut pour cette session.

/model tokenlab-claude/claude-sonnet-5 -s
/model default -s

Exemples de modèles

FournisseurRéférence du modèleDescription
tokenlabtokenlab/gpt-5.6-terraRoute compatible OpenAI
tokenlab-responsestokenlab-responses/gpt-5.6-terraRoute Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Route native Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.5-flashRoute native Gemini
tokenlab-minimaxtokenlab-minimax/minimax-m3Route native MiniMax

Parcourez tous les modèles disponibles sur tokenlab.sh/models.

Quand utiliser quel fournisseur

  • tokenlab : choix par défaut pour la plupart des cas d'utilisation généraux d'agents et de chat.
  • tokenlab-responses : utilisez-le lorsque votre workflow OpenClaw dépend explicitement de la sémantique OpenAI Responses.
  • tokenlab-claude : utilisez-le lorsque vous souhaitez le comportement Messages natif de Claude.
  • tokenlab-gemini : utilisez-le lorsque vous avez besoin du format de requête/réponse natif Gemini ou pour des intégrations existantes de type Gemini.
  • tokenlab-minimax : utilisez-le lorsque vous voulez MiniMax sur sa route native.

Si vous n'avez pas besoin du comportement Gemini natif, vous pouvez toujours appeler les modèles Gemini via tokenlab/gemini-* sur la route compatible OpenAI.

Erreurs courantes

Vérifier la configuration

Redémarrez la même instance et vérifiez modèle et fournisseur. models status sans --probe ne teste pas un appel au modèle. Les sondes réelles et messages peuvent consommer des tokens. Comparez réponse et requête TokenLab. Pour restaurer, choisissez l’ancien modèle et retirez seulement les entrées ajoutées.

openclaw gateway restart
openclaw models status

Étapes suivantes

Une fois qu'OpenClaw est connecté, ces guides vous aideront à utiliser TokenLab plus efficacement :

Sur cette page