OpenClaw Integration mit Claude: 2 Konfigurationsmethoden – OpenAI-kompatibler Modus vs. natives Claude-Format – Vollständiges Tutorial

In OpenClaw (Open WebUI) gibt es zwei Möglichkeiten, ein Großes Sprachmodell anzubinden: den OpenAI-kompatiblen Modus (openai-completions) und das native Claude-Format (anthropic-messages). Viele Nutzer verstehen den Unterschied nicht, was dazu führt, dass sie entweder das falsche Format für Claude-Modelle verwenden oder die erweiterten Funktionen wie Prompt Caching verpassen, die das native Format bietet.

Der Kernnutzen: Nachdem du diesen Artikel gelesen hast, wirst du die vollständige Konfigurationsmethode für beide Anbindungsarten in OpenClaw beherrschen, genau wissen, welches Format für welches Modell geeignet ist, und die Konfigurationscodes direkt kopieren und verwenden können.

Kernvergleich der beiden OpenClaw-Zugriffsmethoden

Ein-Satz-Zusammenfassung der beiden OpenClaw-Zugriffsmethoden

Merken Sie sich eine einfache Regel: Verwenden Sie anthropic-messages für Claude-Modelle und openai-completions für alle anderen Modelle. Der offensichtlichste Unterschied ist die baseUrl – der OpenAI-kompatible Modus endet mit /v1, das native Claude-Format nicht.

Tutorial zur Konfiguration des OpenClaw OpenAI-kompatiblen Modus

Anwendungsfälle für den OpenAI-kompatiblen Modus

Der OpenAI-kompatible Modus (openai-completions) ist die universellste Zugriffsmethode in OpenClaw und eignet sich für alle großen Sprachmodelle außer Claude. Die meisten API-Proxy-Dienste verwenden dieses standardisierte OpenAI-Format.

Vollständiger Konfigurationscode für den OpenAI-kompatiblen Modus

Hier ist die vollständige Konfiguration für den Zugriff auf GPT-5.4 über APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-Ihr-API-Schlüssel",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-Ihr-API-Schlüssel",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

Wichtige Konfigurationspunkte für den OpenAI-kompatiblen Modus

🎯 Konfigurationshinweis: Das /v1 am Ende der baseUrl darf nicht weggelassen werden, es ist der Standardpfad für das OpenAI-kompatible Protokoll. Registrieren Sie sich auf APIYI apiyi.com, um Ihren API-Schlüssel und kostenloses Guthaben zu erhalten.

Claude Native Format Konfigurationsanleitung

Anwendungsfälle für das Claude Native Format

Das Claude Native Format (anthropic-messages) ist die spezielle Anbindungsmethode für die Claude-Modellreihe. Durch die Verwendung des nativen Formats erhalten Sie Zugriff auf exklusive Claude-Funktionen wie Prompt Caching, Extended Thinking und PDF-Verarbeitung.

Vollständiger Konfigurationscode für das Claude Native Format

Hier ist die vollständige Konfiguration für die Anbindung von Claude-Modellen über APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Wichtige Konfigurationspunkte für das Claude Native Format

🎯 Wichtiger Unterschied: Die baseUrl für das Claude Native Format enthält kein /v1. Das ist der häufigste Fehler für Anfänger – wenn die Claude-Anbindung einen Fehler meldet, prüfen Sie zuerst, ob versehentlich /v1 am Ende der URL hinzugefügt wurde.

Konfiguration für die gleichzeitige Verwendung beider Formate in OpenClaw

In der Praxis benötigen Sie wahrscheinlich sowohl allgemeine Modelle als auch Claude-Modelle. In diesem Fall müssen Sie in OpenClaw zwei Provider konfigurieren:

Kombinierter Konfigurationscode für zwei Provider

Schreiben Sie beide Provider-Formate in dieselbe Konfigurationsdatei, dann können Sie in OpenClaw frei zwischen Modellen wechseln:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-你的API密钥",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 Wichtiger Hinweis: Beide Provider können denselben API-Schlüssel verwenden. Der gleiche API-Schlüssel von APIYI apiyi.com unterstützt sowohl das OpenAI-kompatible Format als auch das Claude Native Format, es sind keine mehreren Keys erforderlich.

Fehlerbehebung bei den beiden OpenClaw-Formaten

Der häufigste Fehler bei der Konfiguration ist eine Nichtübereinstimmung zwischen baseUrl und API-Typ. Hier sind die häufigsten Fehler und ihre Lösungen:

🎯 Schnell-Check: OpenAI-Format mit /v1, Claude-Format ohne /v1. Wenn Sie sich das merken, vermeiden Sie 80% der Konfigurationsfehler. Bei anderen Problemen können Sie die vollständige Anleitung im Dokumentationszentrum von APIYI (apiyi.com) einsehen.

Häufig gestellte Fragen

Zusammenfassung

Die Kernpunkte der beiden Zugangsmethoden für OpenClaw:

1. Allgemeine Modelle mit openai-completions: Alle Nicht-Claude-Modelle wie GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax usw. Die baseUrl enthält /v1.
2. Claude-Serie mit anthropic-messages: Modelle wie claude-sonnet-4-6, claude-opus-4-6, claude-haiku usw. Die baseUrl enthält KEIN /v1 und benötigt den anthropic-version-Header.
3. Zwei parallel existierende Provider sind die beste Praxis: Konfigurieren Sie zwei Provider mit demselben API-Schlüssel und wechseln Sie in OpenClaw frei zwischen allen Modellen.

Empfohlen wird, den API-Schlüssel über APIYI (apiyi.com) zu beziehen. Ein einziger Schlüssel ermöglicht den Zugriff auf alle gängigen Modelle wie GPT, Claude, Gemini, DeepSeek usw. und unterstützt sowohl OpenAI-kompatible als auch Claude-native Formate.

📚 Referenzen

1. APIYI Hilfezentrum: Vollständiges Tutorial zur OpenClaw-Konfiguration

   • Link: help.apiyi.com
   • Beschreibung: Enthält detaillierte Anleitungen für verschiedene Seiten und aktuelle Modelllisten.

2. Anthropic API-Dokumentation: Spezifikation des Claude-native API-Formats

   • Link: platform.claude.com/docs/en/api/messages
   • Beschreibung: Vollständige Parameter und Antwortformate für die Messages API.

3. OpenAI SDK-Kompatibilitätsdokumentation: Welche Parameter bei Claude ignoriert werden

   • Link: platform.claude.com/docs/en/api/openai-sdk
   • Beschreibung: Vollständige Liste der unterstützten und nicht unterstützten Parameter.

4. Open WebUI-Dokumentation: Anleitung zur Konfiguration mehrerer Provider in OpenClaw

   • Link: docs.openwebui.com
   • Beschreibung: Provider-Konfiguration, Modellverwaltung und Agent-Einstellungen.

Autor: APIYI Technikteam
Technischer Austausch: Diskussionen sind in den Kommentaren willkommen. Weitere Informationen finden Sie im APIYI Dokumentationszentrum unter docs.apiyi.com.