OpenClaw Claude API Integrationsanleitung

Dieses Tutorial beschreibt ausführlich die verschiedenen Methoden zur Konfiguration der Claude API in OpenClaw, um dir einen schnellen Einstieg zu ermöglichen.

Einführung

OpenClaw ist ein leistungsstarkes KI-Framework, das die Integration verschiedener großer Sprachmodelle unterstützt. Claude ist ein leistungsstarkes KI-Modell von Anthropic, das in den Bereichen Codegenerierung, Inferenzanalyse und anderen Bereichen hervorragende Leistungen erbringt.

Vorbereitung

Bevor du beginnst, benötigst du:

Installation von OpenClaw: npm install -g openclaw
Den entsprechenden API-Zugriff

Methode 1: Nutzung von Defapi (empfohlen)

Wenn du Kosten sparen möchtest, empfehlen wir die Nutzung von Defapi!

Defapi ist eine Plattform zur Aggregation von KI-Modellen, bei der alle Claude-Modelle nur die Hälfte des offiziellen Preises kosten. Defapi unterstützt die OpenAI-kompatible Schnittstelle v1/chat/completions, die einfach zu konfigurieren ist.

Vorteile

Preise zur Hälfte: Claude Sonnet 4.5 kostet nur $1.5/M Eingabe, $7.5/M Ausgabe
Hohe Kompatibilität: Perfekte Kompatibilität mit dem OpenAI-Schnittstellenformat
Stabil und zuverlässig: Schnelle Zugriffszeiten in China

Unterstützte Claude-Modelle

Claude Opus 4.5 / 4.6
Claude Sonnet 4.5
Claude Haiku 4.5

Konfigurationsschritte

Besuche Defapi und registriere ein Konto, um einen API-Schlüssel zu erhalten.
Konfiguriere in OpenClaw:

{
  env: {
    OPENAI_API_KEY: "dein Defapi-Schlüssel",
    OPENAI_BASE_URL: "https://api.defapi.org/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-sonnet-4.5" },
    },
  },
}

Überprüfe die Konfiguration:

# Direktnachrichtentest (empfohlen)
openclaw agent --message "Hallo"

# Oder den Modellstatus überprüfen
openclaw models status

Nach erfolgreicher Überprüfung kannst du mit Claude auf folgende Weise kommunizieren:

# Direktnachricht senden
openclaw agent --message "Hallo"

# Oder die Terminaloberfläche verwenden
openclaw tui

# Oder Gateway starten und über andere Kanäle kommunizieren
openclaw gateway

Jetzt kannst du die leistungsstarken Fähigkeiten von Claude zu halben Preisen genießen!

Methode 2: Offizielle Anthropic API

Dies ist der direkteste Integrationsweg, geeignet für Nutzer mit API-Schlüsseln oder Claude-Abonnements.

Methode 2.1: API-Schlüssel-Authentifizierung

Wenn du einen Anthropic API-Schlüssel (pay-as-you-go) besitzt, ist die Konfiguration sehr einfach:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

Oder füge in der Konfigurationsdatei hinzu:

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Überprüfen:

openclaw agent --message "Hallo"

Methode 2.2: Setup-Token-Authentifizierung

Wenn du ein Claude Max/Pro-Abonnement hast, kannst du das Setup-Token verwenden:

# Im Claude Code CLI generieren
claude setup-token

# In OpenClaw konfigurieren
openclaw models auth setup-token --provider anthropic

Hinweis zur Cachenutzung

Die Anthropic API unterstützt den Cache für Eingaben, was die Leistung verbessert und die Kosten senkt:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "langfristig" },
        },
      },
    },
  },
}

Methode 3: OpenRouter

OpenRouter bietet eine einheitliche API, die den Zugriff auf verschiedene Modelle, einschließlich der Claude-Serie, ermöglicht.

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

Konfiguration:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
    },
  },
}

Überprüfen:

openclaw agent --message "Hallo"

Methode 4: Claude Max API Proxy

Wenn du ein Claude Max-Abonnement hast, aber eine OpenAI-kompatible API benötigst, kannst du das Community-Tool claude-max-api-proxy verwenden:

npm install -g claude-max-api-proxy
claude-max-api

Konfiguriere OpenClaw:

{
  env: {
    OPENAI_API_KEY: "nicht erforderlich",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Überprüfen:

openclaw agent --message "Hallo"

Methode 5: Benutzerdefinierte kompatible API

OpenClaw unterstützt auch benutzerdefinierte Konfigurationen für andere Plattformen, die kompatible APIs anbieten.

Format v1/chat/completions

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-model" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "claude-model", name: "Claude Model", contextWindow: 200000 },
        ],
      },
    },
  },
}

Format v1/messages (Anthropic kompatibel)

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-opus-4" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "claude-opus-4", name: "Claude Opus 4", contextWindow: 200000 },
        ],
      },
    },
  },
}

Häufig verwendete Modellreferenzen

Modell	Konfigurationsreferenz
Claude Opus 4.6	`anthropic/claude-opus-4-6`
Claude Sonnet 4.6	`anthropic/claude-sonnet-4-6`
Claude Haiku 4.6	`anthropic/claude-haiku-4-6`

Fehlersuche

Problem: 401 Fehler / Token ungültig

Führe claude setup-token erneut aus und konfiguriere neu.

Problem: "Kein API-Schlüssel für den Anbieter anthropic gefunden"

Die Authentifizierung erfolgt isoliert pro Agent, stelle sicher, dass der Zielagent korrekt authentifiziert ist.

Problem: Verbindung fehlgeschlagen

Überprüfe die Internetverbindung
Stelle sicher, dass der API-Schlüssel korrekt ist
Überprüfe die baseUrl-Konfiguration