Coding-Tools

Einrichtung des TokenLab-Providers

Konfigurieren Sie TokenLab als benutzerdefinierten Provider in OpenClaw unter Verwendung von OpenAI-, Responses-, Anthropic- und Gemini-kompatiblen Routen

Die Einrichtung meinem Agenten überlassen

Kopieren Sie diese Aufgabe in einen Agenten, der auf Ihrem Computer bereits einsatzbereit ist:

Lies diese Anleitung und hilf mir, OpenClaw mit TokenLab zu verbinden:
https://tokenlab.sh/docs/de/guides/tokenlab-provider
Prüfe zuerst meine installierte Version und die aktive Konfiguration.
Erhalte vorhandene Konten, Anbieter, Berechtigungen und andere Einstellungen.
Sichere lokale Dateien und zeige die vorgeschlagenen Änderungen.
Lass mich benötigte API-Schlüssel lokal eingeben; fordere sie niemals im Chat an, gib sie dort nicht aus und füge sie dort nicht ein.
Prüfe zuerst, ob die Konfiguration geladen werden kann.
Erkläre die Kosten kostenpflichtiger Testanfragen gesondert, bevor du sie ausführst.

Dieser Leitfaden richtet sich an Nutzer von selbst gehostetem OpenClaw, die TokenLab als ihren KI-Provider verbinden möchten.

Empfohlen: Plugin installieren

Optional können Sie das veröffentlichte Anbieter-Plugin 0.1.0 installieren. Stellen Sie TOKENLAB_API_KEY in der unten beschriebenen Gateway-Umgebung bereit und wählen Sie Modelle nur für die Sitzung. Der Einrichtungsassistent ändert das Standardmodell; diese Anleitung führt deshalb openclaw onboard nicht aus. Erhalten Sie bestehende Plugins und Berechtigungen und prüfen Sie Plugin- und Modellliste vor einer Anfrage.

Prüfen Sie die vom Installer angeforderten Fähigkeiten und folgen Sie den Bestätigungsdialogen. Erteilen Sie keine zusätzlichen, sachfremden Rechte und ändern Sie keine Berechtigungen bestehender Plugins.

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

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.

AnbieterOpenClaw apiAm besten fürbaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen und die meisten OpenAI-kompatiblen Aufrufehttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesOpenAI Responses-Workflows, die /v1/responses-Semantik erwartenhttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesNatives Claude Messages APIhttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiNative Gemini-API-Formathttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesNative MiniMax-Routinghttps://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
  • OpenClaw 2026.9.4 erfordert Node.js >=24.16.0 <25 || >=26.1.0 (Versionsanforderungen). Prüfen Sie für andere OpenClaw-Versionen die jeweiligen Anforderungen.
  • Einen TokenLab API-Schlüssel — Hier erhalten

Konfiguration

Bearbeiten Sie Ihre OpenClaw-Konfiguration:

  • Selbst gehostet: ~/.openclaw/openclaw.json

Fügen Sie TokenLab-Provider unter models.providers hinzu:

Nutzen Sie dasselbe Profil, OPENCLAW_STATE_DIR und OPENCLAW_CONFIG_PATH wie der laufende Gateway. Sichern Sie die Konfiguration. Speichern Sie TOKENLAB_API_KEY in der vertrauenswürdigen globalen .env oder Dienstumgebung dieser Instanz. Terminal-export und Projekt-.env reichen für den Hintergrunddienst nicht immer. Siehe Umgebung.

Sichern Sie die aktive Konfiguration. Ergänzen Sie nur den TokenLab-Eintrag und erhalten Sie vorhandene Anbieter, Konten, Standardmodell und Berechtigungen. Wählen Sie bei einem belegten Namen einen anderen und passen Sie die Befehle an. Entfernen Sie zum Rückgängigmachen nur den neuen Eintrag oder stellen Sie dessen Sicherung 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-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" }
        ]
      }
    }
  }
}

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:

Wählen Sie unter OpenClaw 2026.9.4 das Modell mit -s nur für die aktuelle Sitzung. Lassen Sie agents.defaults.model, Agentenstandards und Berechtigungen unverändert. /model default -s stellt die konfigurierte Standardauswahl für diese Sitzung wieder her.

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

Modellbeispiele

AnbieterModellreferenzBeschreibung
tokenlabtokenlab/gpt-5.6-terraOpenAI-kompatibler Pfad
tokenlab-responsestokenlab-responses/gpt-5.6-terraResponses API-Pfad
tokenlab-claudetokenlab-claude/claude-sonnet-5Native Claude Messages-Route
tokenlab-geminitokenlab-gemini/gemini-3.5-flashNative Gemini-Route
tokenlab-minimaxtokenlab-minimax/minimax-m3Native MiniMax-Route

Alle verfügbaren Modelle finden Sie unter tokenlab.sh/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

Einrichtung verifizieren

Starten Sie dieselbe Instanz neu und prüfen Sie Modell und Anbieter. models status ohne --probe testet keinen Modellaufruf. Live-Probes und Chats können Token verbrauchen. Vergleichen Sie Antwort und TokenLab-Anfrageprotokoll. Zum Wiederherstellen wählen Sie das alte Modell und entfernen nur hinzugefügte Einträge.

openclaw gateway restart
openclaw models status

Nächste Schritte

Sobald OpenClaw verbunden ist, helfen Ihnen diese Guides, TokenLab effektiver zu nutzen:

  • API-Formate — Verstehen Sie die Unterschiede zwischen OpenAI-, Responses-, Anthropic- und Gemini-Routen
  • IDE-/SDK-Kompatibilität — Prüfen Sie, wann /v1/responses die bessere Wahl ist
  • Fehlerbehandlung — Erfahren Sie gängige Ausfallursachen und Wiederherstellungsmuster
  • Modellübersicht — Durchstöbern Sie Modell-IDs, bevor Sie sie in Agenten einbinden

Auf dieser Seite