Coding-Tools
TokenLab Provider Setup
Verbinden einer selbst gehosteten OpenClaw-Instanz mit TokenLab
Meinen Agenten diese Einrichtung vornehmen lassen
Kopieren Sie diese Aufgabe in einen Agenten, der bereits auf Ihrem Computer läuft:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/de/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.Diese Anleitung ist für selbst gehostetes OpenClaw. Das TokenLab-Plugin ist die schnellste Einrichtung; eine manuelle Konfiguration ist verfügbar, wenn Sie ein spezifisches API-Format benötigen.
Plugin installieren
Optional: Installieren Sie das veröffentlichte Provider-Plugin 0.1.3. Stellen Sie den TOKENLAB_API_KEY über dieselbe Gateway-Umgebung bereit, die unten beschrieben wird, und verwenden Sie die sitzungsbasierte Modellauswahl. Der Onboarding-Assistent des Plugins ändert das Standardmodell, daher führt diese Anleitung kein openclaw onboard aus. Behalten Sie bestehende Plugin-Einträge und Berechtigungen bei. Überprüfen Sie das installierte Plugin und die Modellliste, bevor Sie eine Anfrage stellen.
Überprüfen Sie die vom Installationsprogramm angeforderten Funktionen und folgen Sie den Bestätigungsaufforderungen des Clients. Erteilen Sie keine nicht zusammenhängenden Berechtigungen und ändern Sie nicht die Berechtigungen bestehender Plugins.
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 -sProvider manuell konfigurieren
Verwenden Sie models.providers nur, wenn OpenClaw die Formate Responses, Claude Messages, Gemini oder MiniMax separat benötigt. Für normalen Chat reicht der tokenlab-Eintrag aus.
| Provider | OpenClaw api | Am besten geeignet 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 | Native Claude Messages API | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | Natives Gemini API-Format | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | MiniMax-Modelle über das Messages-Format | https://api.tokenlab.sh |
Verwenden Sie das /v1-Suffix 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, da OpenClaw sonst möglicherweise den falschen Provider-Pfad erstellt.
Voraussetzungen
- Eine selbst gehostete OpenClaw-Instanz
- Für OpenClaw 2026.9.4, verwenden Sie Node.js
>=24.16.0 <25 || >=26.1.0(Versionsanforderungen). Für andere OpenClaw-Releases prüfen Sie die Anforderungen des jeweiligen Releases. - Ein TokenLab API Key — Hier erhalten
Konfiguration
Bearbeiten Sie Ihre OpenClaw-Konfiguration:
- Selbst gehostet:
~/.openclaw/openclaw.json
Fügen Sie TokenLab-Provider unter models.providers hinzu:
Verwenden Sie dasselbe Profil, OPENCLAW_STATE_DIR und OPENCLAW_CONFIG_PATH wie das laufende Gateway. Sichern Sie die aktive Konfiguration vor dem Zusammenführen. Platzieren Sie TOKENLAB_API_KEY in der vertrauenswürdigen globalen .env oder Service-Umgebung dieser Instanz; ein Terminal-Export oder eine reine Projekt-.env erreicht das Hintergrund-Gateway möglicherweise nicht. Siehe Umgang mit Umgebungsvariablen.
Sichern Sie die aktive Konfiguration. Fügen Sie nur den TokenLab-Eintrag hinzu und behalten Sie bestehende Provider, Konten, die Standard-Modellauswahl und Berechtigungen bei. Wenn der Name bereits verwendet wird, wählen Sie einen anderen Namen und aktualisieren Sie die Befehle. Um die Einrichtung rückgängig zu machen, entfernen Sie nur Ihren hinzugefügten Eintrag oder stellen Sie das vorherige Backup wieder her.
{
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" }
]
}
}
}
}Alle 5 Provider verwenden denselben API Key. Sie benötigen nur ein TokenLab-Konto.
Die obigen models-Arrays zeigen nur gängige Beispiele. Fügen Sie bei Bedarf weitere Modell-IDs zu jedem Provider hinzu.
Modelle verwenden
OpenClaw referenziert Modelle weiterhin im Format provider/model:
Für OpenClaw 2026.9.4, wählen Sie das Modell nur für die aktuelle Sitzung mit -s. Lassen Sie agents.defaults.model, Agenten-Standardeinstellungen und Berechtigungen unverändert. Verwenden Sie /model default -s, um diese Sitzung auf ihren konfigurierten Standard zurückzusetzen.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sModellbeispiele
| Provider | Modellreferenz | Beschreibung |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | OpenAI-kompatibel (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Responses API |
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 über Messages |
Durchsuchen Sie alle verfügbaren Modelle unter tokenlab.sh/models.
Wann welcher Provider zu verwenden ist
tokenlab: Standardwahl für die meisten allgemeinen Agenten- und Chat-Anwendungsfälle.tokenlab-responses: verwenden, wenn Ihr OpenClaw-Workflow explizit von der OpenAI Responses-Semantik abhängt.tokenlab-claude: verwenden, wenn Sie das native Claude Messages-Verhalten wünschen.tokenlab-gemini: verwenden, wenn Sie Gemini-natives Request/Response-Format oder bestehende Gemini-Stil-Integrationen wünschen.tokenlab-minimax: verwenden, wenn Sie MiniMax-Modelle über das Messages-Format wünschen.
Wenn Sie kein Gemini-natives Verhalten benötigen, können Sie Gemini-Modelle weiterhin über tokenlab/gemini-* im OpenAI-kompatiblen Format aufrufen.
Häufige Fehler
Einrichtung überprüfen
Starten Sie die Instanz neu und überprüfen Sie dann das ausgewählte Modell und den Provider. models status ohne --probe führt keinen Modell-Aufruf-Test durch. Ein Live---probe oder eine Chat-Nachricht kann Token verbrauchen. Überprüfen Sie eine echte Antwort gegen die passende TokenLab-Anfrage, bevor Sie die Einrichtung als funktionierend erklären. Um den Zustand wiederherzustellen, wählen Sie das vorherige Modell und entfernen Sie nur die von Ihnen hinzugefügten TokenLab-Einträge.
openclaw gateway restart
openclaw models statusBilder und Videos im selben Agenten generieren
OpenClaw kann auch Bilder und kurze Videos mit dem TokenLab MCP server erstellen. Jede Generierung wird vom selben TokenLab-Guthaben bezahlt.
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 tokenlabBehalten Sie die einfachen Anführungszeichen bei. OpenClaw speichert dann eine Referenz auf die Variable, nicht den Key, und liest TOKENLAB_API_KEY aus der Umgebung, in der es läuft, wenn der Server gestartet wird. Der Probe-Befehl listet die TokenLab-Tools auf. Versuchen Sie dann:
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 gibt eine Aufgaben-ID zurück. Der Agent ruft get_task_status auf, bis das Video fertig ist.
Nächste Schritte
Sobald OpenClaw verbunden ist, helfen Ihnen diese Anleitungen dabei, TokenLab effektiver zu nutzen:
- API Formats — Verstehen Sie die Unterschiede zwischen OpenAI-, Responses-, Anthropic- und Gemini-Routen
- IDE / SDK Compatibility — Sehen Sie, wann
/v1/responsesbesser geeignet ist - Error Handling — Lernen Sie häufige Fehlermodi und Wiederherstellungsmuster kennen
- Models Overview — Durchsuchen Sie Modell-IDs, bevor Sie diese in Agenten einbinden