> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuration du fournisseur TokenLab
> Configurer TokenLab comme fournisseur personnalisé dans OpenClaw en utilisant les routes compatibles OpenAI, Responses, Anthropic et Gemini
Ce guide s'adresse aux utilisateurs d'**OpenClaw auto-hébergé** qui souhaitent connecter TokenLab comme fournisseur IA.
## Recommandé : installer le plugin
Pour l'exécution standard des agents OpenClaw, installez le plugin fournisseur TokenLab :
```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```
Le plugin récupère le catalogue actif des modèles de chat TokenLab et conserve 18 modèles de secours pour la découverte hors ligne. Les modèles utilisent le format `tokenlab/`.
[Package npm](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [Fiche ClawHub](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [Code source](https://github.com/hedging8563/tokenlab-openclaw-provider)
## 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**.
| Fournisseur | OpenClaw `api` | 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 s'attendent à la sémantique `/v1/responses` | `https://api.tokenlab.sh/v1` |
| `tokenlab-claude` | `anthropic-messages` | API Messages native de Claude | `https://api.tokenlab.sh` |
| `tokenlab-gemini` | `google-generative-ai` | Format API Gemini natif | `https://api.tokenlab.sh` |
| `tokenlab-minimax` | `anthropic-messages` | Routage MiniMax natif | `https://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
* Une clé API TokenLab — [Get one here](https://tokenlab.sh/dashboard)
## Configuration
Modifiez votre configuration OpenClaw :
* **Auto-hébergé** : `~/.openclaw/openclaw.json`
Ajoutez les fournisseurs TokenLab sous `models.providers` :
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-claude/claude-sonnet-4-6"
}
}
},
models: {
mode: "merge",
providers: {
tokenlab: {
api: "openai-completions",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "gpt-4o", name: "GPT-4o" },
{ id: "deepseek-r1", name: "DeepSeek R1" },
{ id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
]
},
"tokenlab-responses": {
api: "openai-responses",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "gpt-4o", name: "GPT-4o (Responses)" },
{ id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
]
},
"tokenlab-claude": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "sk-your-tokenlab-key",
models: [
{ id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
{ id: "claude-opus-4-6", name: "Claude Opus 4.6" }
]
},
"tokenlab-gemini": {
api: "google-generative-ai",
baseUrl: "https://api.tokenlab.sh",
apiKey: "sk-your-tokenlab-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: "sk-your-tokenlab-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` :
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-gemini/gemini-3.5-flash"
}
}
}
}
```
### Exemples de modèles
| Fournisseur | Référence du modèle | Description |
| -------------------- | ----------------------------------- | ------------------------------- |
| `tokenlab` | `tokenlab/gpt-4o` | Route compatible OpenAI |
| `tokenlab` | `tokenlab/deepseek-r1` | Modèle de raisonnement DeepSeek |
| `tokenlab-responses` | `tokenlab-responses/gpt-4o` | Route Responses API |
| `tokenlab-claude` | `tokenlab-claude/claude-sonnet-4-6` | Route native Claude Messages |
| `tokenlab-gemini` | `tokenlab-gemini/gemini-3.5-flash` | Route native Gemini |
| `tokenlab-minimax` | `tokenlab-minimax/minimax-m3` | Route native MiniMax |
Parcourez tous les modèles disponibles sur [tokenlab.sh/models](https://tokenlab.sh/fr/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
La documentation actuelle d'OpenClaw utilise `models.providers`. Si vous conservez l'ancien format du tableau `providers` au niveau supérieur, OpenClaw peut ignorer la configuration ou échouer à résoudre les préfixes des fournisseurs comme prévu.
`openai-responses` mappe vers le chemin `/v1/responses` de TokenLab, donc `tokenlab-responses` doit utiliser `https://api.tokenlab.sh/v1`.
`anthropic-messages` et `google-generative-ai` doivent utiliser `https://api.tokenlab.sh` sans `/v1`. L'ajout de `/v1` peut produire des chemins de requête incorrects.
Oui. La documentation actuelle d'OpenClaw inclut toujours le fournisseur intégré `google` et prend également en charge les fournisseurs personnalisés utilisant `api: "google-generative-ai"`. Ainsi, `tokenlab-gemini` reste une route Gemini native valide pour les utilisateurs d'OpenClaw.
## Vérifier la configuration
Après avoir enregistré la configuration, redémarrez votre instance OpenClaw et testez avec un message simple. Si vous recevez une réponse, le fournisseur est configuré correctement.
```bash theme={null}
# Auto-hébergé : redémarrez le service
systemctl --user restart openclaw # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw # macOS
```
## Étapes suivantes
Une fois qu'OpenClaw est connecté, ces guides vous aideront à utiliser TokenLab plus efficacement :
* [Formats d'API](/guides/api-formats) — comprenez les différences entre les routes OpenAI, Responses, Anthropic et Gemini
* [IDE / SDK Compatibility](/guides/ide-sdk-compatibility) — voyez quand `/v1/responses` est la meilleure option
* [Gestion des erreurs](/guides/error-handling) — apprenez les modes d'échec courants et les stratégies de récupération
* [Aperçu des modèles](https://tokenlab.sh/fr/models) — parcourez les IDs de modèles avant de les intégrer aux agents