Outils de code
Configuration du fournisseur TokenLab
Connecter une instance OpenClaw auto-hébergée à TokenLab
Laisser mon agent effectuer cette configuration
Copiez cette tâche vers un agent déjà en cours d'exécution sur votre ordinateur :
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/fr/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Ce guide est destiné à OpenClaw auto-hébergé. Le plugin TokenLab est la méthode de configuration la plus rapide ; une configuration manuelle est disponible si vous avez besoin d'un format d'API spécifique.
Installer le plugin
Optionnel : installez le plugin de fournisseur publié 0.1.3. Fournissez TOKENLAB_API_KEY via l'environnement Gateway décrit ci-dessous et utilisez la sélection de modèle par session uniquement. L'assistant d'intégration du plugin modifie le modèle par défaut, c'est pourquoi ce guide n'exécute pas openclaw onboard. Conservez les entrées et permissions de plugin existantes. Vérifiez le plugin installé et la liste des modèles avant d'effectuer une requête.
Examinez les capacités demandées par l'installateur et suivez les invites de confirmation du client. N'accordez pas de permissions non liées et ne modifiez pas les permissions des plugins existants.
openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sConfigurer les fournisseurs manuellement
Utilisez models.providers uniquement lorsque OpenClaw a besoin des formats Responses, Claude Messages, Gemini ou MiniMax séparément. Pour une discussion ordinaire, l'entrée tokenlab suffit.
| Fournisseur | api OpenClaw | Idéal pour | baseUrl |
|---|---|---|---|
tokenlab | openai-completions | GPT, DeepSeek, Qwen et la plupart des appels compatibles OpenAI | https://api.tokenlab.sh/v1 |
tokenlab-responses | openai-responses | Workflows OpenAI Responses qui attendent la sémantique /v1/responses | https://api.tokenlab.sh/v1 |
tokenlab-claude | anthropic-messages | API native Claude Messages | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | Format d'API natif Gemini | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | Modèles MiniMax via le format Messages | https://api.tokenlab.sh |
Utilisez le suffixe /v1 uniquement 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 pourrait construire un chemin de fournisseur incorrect.
Prérequis
- Une instance OpenClaw auto-hébergée
- Pour OpenClaw 2026.9.4, utilisez Node.js
>=24.16.0 <25 || >=26.1.0(exigences de version). Pour les autres versions d'OpenClaw, vérifiez les exigences de cette version. - Une clé API TokenLab — Obtenez-en une ici
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 Gateway en cours d'exécution. Sauvegardez la configuration active avant de fusionner. Placez TOKENLAB_API_KEY dans le fichier .env global de confiance de cette instance ou dans l'environnement de service ; un export de terminal ou un .env de projet seul pourrait ne pas atteindre la Gateway en arrière-plan. Voir gestion de l'environnement.
Sauvegardez la configuration active. Ajoutez uniquement l'entrée TokenLab et préservez les fournisseurs, comptes, sélection de modèle par défaut et permissions existants. Si le nom est déjà utilisé, choisissez un autre nom et mettez à jour les commandes. Pour annuler la configuration, supprimez uniquement l'entrée ajoutée ou restaurez la 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-v4-pro", name: "DeepSeek V4 Pro" },
{ 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.6-flash", name: "Gemini 3.6 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 ne montrent que des exemples courants. Ajoutez d'autres ID de modèles à chaque fournisseur selon vos besoins.
Utilisation des modèles
OpenClaw référence toujours les modèles avec le format provider/model :
Pour OpenClaw 2026.9.4, sélectionnez le modèle uniquement pour la session en cours avec -s. Laissez agents.defaults.model, les valeurs par défaut de l'agent et les permissions inchangés. Utilisez /model default -s pour ramener cette session à sa configuration par défaut.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sExemples de modèles
| Fournisseur | Référence du modèle | Description |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | Compatible OpenAI (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | API Responses |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | MiniMax via Messages |
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 d'agents et de discussion.tokenlab-responses: à utiliser lorsque votre workflow OpenClaw dépend explicitement de la sémantique OpenAI Responses.tokenlab-claude: à utiliser lorsque vous souhaitez le comportement natif Messages de Claude.tokenlab-gemini: à utiliser lorsque vous souhaitez un formatage de requête/réponse natif Gemini ou des intégrations existantes de style Gemini.tokenlab-minimax: à utiliser lorsque vous souhaitez des modèles MiniMax via le format Messages.
Si vous n'avez pas besoin du comportement natif Gemini, vous pouvez toujours appeler les modèles Gemini via tokenlab/gemini-* au format compatible OpenAI.
Erreurs courantes
Vérifier la configuration
Redémarrez l'instance, puis inspectez le modèle et le fournisseur sélectionnés. models status sans --probe n'effectue pas de test d'appel de modèle. Un --probe en direct ou un message de discussion peut consommer des jetons. Vérifiez une réponse réelle par rapport à la requête TokenLab correspondante avant de déclarer que la configuration fonctionne. Pour restaurer, choisissez le modèle précédent et supprimez uniquement les entrées TokenLab ajoutées.
openclaw gateway restart
openclaw models statusGénérer des images et des vidéos dans le même agent
OpenClaw peut également créer des images et de courtes vidéos avec le serveur MCP TokenLab. Chaque génération est payée à partir du même solde TokenLab.
openclaw mcp add tokenlab \
--command npx \
--arg -y \
--arg @tokenlabai/mcp-server@0.6.48 \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlabGardez les guillemets simples. OpenClaw stocke alors une référence à la variable, et non la clé, et lit TOKENLAB_API_KEY depuis l'environnement dans lequel il s'exécute au démarrage du serveur. La sonde liste les outils TokenLab. Essayez ensuite :
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video renvoie un ID de tâche. L'agent appelle get_task_status jusqu'à ce que la vidéo soit prête.
Étapes suivantes
Une fois OpenClaw connecté, ces guides vous aideront à utiliser TokenLab plus efficacement :
- Formats d'API — comprendre les différences entre les routes OpenAI, Responses, Anthropic et Gemini
- Compatibilité IDE / SDK — voir quand
/v1/responsesest le meilleur choix - Gestion des erreurs — apprendre les modes de défaillance courants et les modèles de récupération
- Vue d'ensemble des modèles — parcourir les ID de modèles avant de les intégrer aux agents