> ## 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.
# Einrichtung des TokenLab-Providers
> Konfigurieren Sie TokenLab als benutzerdefinierten Provider in OpenClaw unter Verwendung von OpenAI-, Responses-, Anthropic- und Gemini-kompatiblen Routen
Dieser Leitfaden richtet sich an Nutzer von **selbst gehostetem OpenClaw**, die TokenLab als ihren KI-Provider verbinden möchten.
## Empfohlen: Plugin installieren
Installieren Sie für die reguläre OpenClaw-Agentenausführung das TokenLab-Provider-Plugin:
```bash theme={null}
openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"
```
Das Plugin lädt den aktuellen Chatmodell-Katalog von TokenLab und hält 18 Fallback-Modelle für die Offline-Erkennung bereit. Modelle verwenden das Format `tokenlab/`.
[npm-Paket](https://www.npmjs.com/package/@tokenlabai/openclaw-provider) · [ClawHub-Eintrag](https://clawhub.ai/tokenlabai/plugins/openclaw-provider) · [Quellcode](https://github.com/hedging8563/tokenlab-openclaw-provider)
## Manuelle Provider-Konfiguration
Verwenden Sie die nachfolgenden manuellen `models.providers`-Einträge nur, wenn Sie getrennte Routen für **Responses API**, **Claude native**, **Gemini native** oder **MiniMax native** benötigen.
Wenn Sie die manuelle Konfiguration wählen, reicht es aus, nur `tokenlab` zu konfigurieren. Fügen Sie die anderen Provider nur hinzu, wenn Sie explizit **Responses API**, **Claude native**, **Gemini native** oder **MiniMax native** Verhalten benötigen.
| Anbieter | OpenClaw `api` | Am besten für | baseUrl |
| -------------------- | ---------------------- | ----------------------------------------------------------------- | ---------------------------- |
| `tokenlab` | `openai-completions` | GPT, DeepSeek, Qwen und die meisten OpenAI-kompatiblen Aufrufe | `https://api.tokenlab.sh/v1` |
| `tokenlab-responses` | `openai-responses` | OpenAI Responses-Workflows, die `/v1/responses`-Semantik erwarten | `https://api.tokenlab.sh/v1` |
| `tokenlab-claude` | `anthropic-messages` | Natives Claude Messages API | `https://api.tokenlab.sh` |
| `tokenlab-gemini` | `google-generative-ai` | Native Gemini-API-Format | `https://api.tokenlab.sh` |
| `tokenlab-minimax` | `anthropic-messages` | Native MiniMax-Routing | `https://api.tokenlab.sh` |
Verwenden Sie den Suffix `/v1` nur für `openai-completions` und `openai-responses`.
Native Provider wie `anthropic-messages` und `google-generative-ai` sollten `https://api.tokenlab.sh` ohne `/v1` verwenden, andernfalls kann OpenClaw den falschen Upstream-Pfad konstruieren.
## Voraussetzungen
* Eine selbst gehostete OpenClaw-Instanz
* Einen TokenLab API-Schlüssel — [Hier erhalten](https://tokenlab.sh/dashboard)
## Konfiguration
Bearbeiten Sie Ihre OpenClaw-Konfiguration:
* **Selbst gehostet**: `~/.openclaw/openclaw.json`
Fügen Sie TokenLab-Provider unter `models.providers` hinzu:
```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" }
]
}
}
}
}
```
Alle 5 Provider verwenden denselben **API-Schlüssel**. Sie benötigen nur ein TokenLab-Konto.
Die oben gezeigten `models`-Arrays enthalten nur gängige Beispiele. Fügen Sie je nach Bedarf weitere Modell-IDs zu jedem Provider hinzu.
## Verwendung von Modellen
OpenClaw referenziert Modelle weiterhin im Format `provider/model`:
```json5 theme={null}
{
agents: {
defaults: {
model: {
primary: "tokenlab-gemini/gemini-3.5-flash"
}
}
}
}
```
### Modellbeispiele
| Anbieter | Modellreferenz | Beschreibung |
| -------------------- | ----------------------------------- | ---------------------------- |
| `tokenlab` | `tokenlab/gpt-4o` | OpenAI-kompatibler Pfad |
| `tokenlab` | `tokenlab/deepseek-r1` | DeepSeek-Reasoning-Modell |
| `tokenlab-responses` | `tokenlab-responses/gpt-4o` | Responses API-Pfad |
| `tokenlab-claude` | `tokenlab-claude/claude-sonnet-4-6` | Native Claude Messages-Route |
| `tokenlab-gemini` | `tokenlab-gemini/gemini-3.5-flash` | Native Gemini-Route |
| `tokenlab-minimax` | `tokenlab-minimax/minimax-m3` | Native MiniMax-Route |
Alle verfügbaren Modelle finden Sie unter [tokenlab.sh/models](https://tokenlab.sh/de/models).
## Wann Sie welchen Provider verwenden sollten
* `tokenlab`: Standardwahl für die meisten allgemeingültigen Agent- und Chat-Anwendungsfälle.
* `tokenlab-responses`: Verwenden Sie diesen, wenn Ihr OpenClaw-Workflow explizit auf OpenAI Responses-Semantik angewiesen ist.
* `tokenlab-claude`: Verwenden Sie diesen, wenn Sie Claudes native Messages-Verhalten möchten.
* `tokenlab-gemini`: Verwenden Sie diesen, wenn Sie Gemini-native Anfrage-/Antwort-Formatierung oder bestehende Gemini-Integrationen benötigen.
* `tokenlab-minimax`: Verwenden Sie diesen, wenn Sie MiniMax über dessen native Route nutzen möchten.
Wenn Sie kein Gemini-native Verhalten benötigen, können Sie Gemini-Modelle weiterhin über `tokenlab/gemini-*` über die OpenAI-kompatible Route aufrufen.
## Häufige Fehler
Die aktuelle OpenClaw-Dokumentation verwendet `models.providers`. Wenn Sie weiterhin das ältere Top-Level-`providers`-Array-Format beibehalten, kann OpenClaw die Konfiguration ignorieren oder die Provider-Präfixe nicht wie erwartet auflösen.
`openai-responses` mappt auf TokenLabs `/v1/responses`-Pfad, daher muss `tokenlab-responses` `https://api.tokenlab.sh/v1` verwenden.
`anthropic-messages` und `google-generative-ai` sollten `https://api.tokenlab.sh` ohne `/v1` verwenden. Das Hinzufügen von `/v1` kann zu falschen Anforderungs-Pfaden führen.
Ja. Die aktuelle OpenClaw-Dokumentation enthält weiterhin den eingebauten `google`-Provider und unterstützt außerdem benutzerdefinierte Provider mit `api: "google-generative-ai"`. `tokenlab-gemini` bleibt daher eine gültige native Gemini-Route für OpenClaw-Nutzer.
## Einrichtung verifizieren
Nach dem Speichern der Konfiguration starten Sie Ihre OpenClaw-Instanz neu und testen Sie mit einer einfachen Nachricht. Wenn Sie eine Antwort erhalten, ist der Provider korrekt konfiguriert.
```bash theme={null}
# Selbst gehostet: Dienst neu starten
systemctl --user restart openclaw # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw # macOS
```
## Nächste Schritte
Sobald OpenClaw verbunden ist, helfen Ihnen diese Guides, TokenLab effektiver zu nutzen:
* [API-Formate](/guides/api-formats) — Verstehen Sie die Unterschiede zwischen OpenAI-, Responses-, Anthropic- und Gemini-Routen
* [IDE-/SDK-Kompatibilität](/guides/ide-sdk-compatibility) — Prüfen Sie, wann `/v1/responses` die bessere Wahl ist
* [Fehlerbehandlung](/guides/error-handling) — Erfahren Sie gängige Ausfallursachen und Wiederherstellungsmuster
* [Modellübersicht](https://tokenlab.sh/de/models) — Durchstöbern Sie Modell-IDs, bevor Sie sie in Agenten einbinden