Source: https://aiprimetech.io/de/learn/run-openclaw-with-claude-api/ [Startseite](/de/) / [Lernen](/de/learn/) / OpenClaw mit unbegrenzter Claude-Nutzung betreiben # OpenClaw unbegrenzt mit Claude betreiben OpenClaw ist ein KI-Gateway für mehrere Kanäle, das Claude über eine Hub-and-Spoke-Architektur mit mehr als 50 Messaging-Kanälen verbindet. Jeder Kanal ist ein unabhängiger Inferenzendpunkt – Telegram-Bots, Discord-Server, Slack-Workspaces, Web-Widgets und benutzerdefinierte Integrationen werden alle über ein zentrales Gateway auf Ihrer Infrastruktur geleitet. Da Skills in System-Prompts eingefügt werden und die Kanäle dauerhaft geöffnet bleiben, bedeutet OpenClaw eine kontinuierliche API-Nutzung rund um die Uhr, die linear mit der Anzahl aktiver Kanäle und Nutzer skaliert. ## Die dauerhaft aktive Architektur von OpenClaw OpenClaw arbeitet als Hub-and-Spoke-Gateway. Der Hub ist ein zentraler Prozess, der typischerweise auf einem VPS an Port 18789 läuft und die Modellkonfiguration, das Einfügen von Skills und das Routing von Anfragen verwaltet. Die Spokes sind Kanal-Konnektoren – jeder hält eine dauerhafte Verbindung zu einer Messaging-Plattform aufrecht und leitet eingehende Nachrichten zur Inferenz an den Hub weiter. Jeder Kanal ist eine ständig offene Quelle für Inferenzanfragen. Wenn ein Nutzer auf einer verbundenen Plattform eine Nachricht sendet, leitet der Kanal-Konnektor sie an den Hub weiter. Dieser erstellt den vollständigen Prompt (System-Prompt + Skills + Gesprächsverlauf + Nutzernachricht), sendet ihn an Claude und streamt die Antwort zurück an den Kanal. Es gibt weder Warteschlangen noch Stapelverarbeitung – jede Nachricht wird sofort per Inferenz verarbeitet. Das Gateway schläft nie. Solange der Prozess läuft, sind alle 50+ Kanäle aktiv, und jede eingehende Nachricht löst einen Claude-API-Aufruf aus. Anders als interaktive Tools, die nur dann Tokens verbrauchen, wenn ein Entwickler arbeitet, verbraucht OpenClaw Tokens, sobald ein Nutzer auf irgendeinem Kanal eine Nachricht sendet. Bei aktiv genutzten Bereitstellungen bedeutet das Hunderte oder Tausende Aufrufe pro Tag. Unbegrenzter Zugang ist damit für ernsthafte Bereitstellungen nicht nur praktisch, sondern wirtschaftlich notwendig. ## Anbieterkonfiguration in openclaw.json Die Modellkonfiguration von OpenClaw befindet sich in ~/.openclaw/openclaw.json im Block models.providers. Jeder Anbietereintrag benötigt einen Namen, das Feld api (dieses MUST für Claude ausdrücklich auf 'anthropic-messages' gesetzt werden – es gibt keinen Standardwert), baseUrl mit der Adresse Ihres Gateways und apiKey für die Authentifizierung. Das Feld api steuert, welches Anfrageformat OpenClaw verwendet. Setzen Sie baseUrl auf https://aiprimetech.io (Root-Host, ohne /v1 – der anthropic-messages-Handler hängt den richtigen Pfad an). Für apiKey können Sie direkte Werte oder die Interpolation von Umgebungsvariablen mit der Syntax ${ENV_VAR} verwenden. Die Interpolation hilft dabei, Geheimnisse aus der Konfigurationsdatei herauszuhalten: Setzen Sie apiKey auf '${UNLIMITED_API_KEY}' und exportieren Sie die Variable in Ihrer Shell oder systemd-Unit. Sie können in der Anbieterkonfiguration auch benutzerdefinierte Header angeben. Verwenden Sie das Feld headers, um anthropic-beta-Flags oder benutzerdefinierte Routing-Header zu übergeben. Beispielsweise aktiviert headers: {'anthropic-beta': 'max-tokens-3-5-sonnet-2024-07-15'} eine erweiterte Ausgabe für unterstützte Modelle. Beim Gateway mit unbegrenzter Nutzung funktionieren Standard-Header ohne Änderungen. ## Modelleinträge und das erforderliche api-Feld Ein wichtiger Fallstrick bei der OpenClaw-Konfiguration: Das Feld api in jedem Modelleintrag MUST ausdrücklich auf 'anthropic-messages' gesetzt werden. Wird es weggelassen, verwendet OpenClaw standardmäßig ein generisches Completion-Format, das mit Claude inkompatibel ist. Das führt zu kryptischen Fehlern, die wie Verbindungsprobleme aussehen, tatsächlich aber durch nicht übereinstimmende Formate entstehen. Fügen Sie in jedem Claude-Modelleintrag immer api: 'anthropic-messages' hinzu. Definieren Sie Modelleinträge unter models.models in openclaw.json. Jeder Eintrag verweist über den Namen auf einen Anbieter und legt die Modell-ID fest. Erstellen Sie Einträge für jede Claude-Variante: claude-sonnet-4-5 als Standard für die meisten Kanäle, claude-opus-4-6 für Kanäle, die tiefgehenderes logisches Denken benötigen, und claude-haiku-4-5 für Kanäle mit hohem Nachrichtenaufkommen, bei denen Geschwindigkeit wichtiger ist als Tiefe. Weisen Sie den Kanälen in der Kanalkonfiguration Modelle zu. Jeder Kanal kann ein anderes Modell verwenden – ein Kundensupport-Kanal könnte Sonnet für ausgewogene Antworten nutzen, ein technischer Kanal Opus für komplexe Erklärungen und ein Benachrichtigungskanal Haiku für schnelle Bestätigungen. Bei unbegrenzter Nutzung richten Sie die Zuweisung nach den Qualitätsanforderungen, ohne die Kosten berücksichtigen zu müssen. ## Hub-and-Spoke-Gateway an Port 18789 Das OpenClaw-Gateway läuft typischerweise an Port 18789 (konfigurierbar in openclaw.json unter server.port). Es stellt eine REST-API bereit, über die Kanal-Konnektoren Nachrichten übermitteln und Antworten empfangen. Das Gateway übernimmt intern die Prompt-Erstellung, Modellauswahl, Verwaltung des Gesprächsverlaufs und das Streaming von Antworten. Stellen Sie das Gateway auf einem VPS mit zuverlässiger Verfügbarkeit bereit – es muss 24/7 laufen, damit die Kanäle weiterhin reagieren. Verwenden Sie systemd oder Docker, um einen automatischen Neustart nach Abstürzen sicherzustellen. Der Prozess benötigt wenig CPU-Leistung und Arbeitsspeicher; der Engpass ist stets die Latenz der Aufrufe an die vorgelagerte API und nicht die lokale Verarbeitung. Ein kleiner VPS (1 CPU, 1 GB RAM) bewältigt problemlos Dutzende gleichzeitig aktiver Kanäle. Das Gateway hält Gesprächsverläufe im Arbeitsspeicher vor; eine dauerhafte Speicherung auf Festplatte oder in Redis ist konfigurierbar. Jedes aktive Gespräch auf allen Kanälen hat seinen eigenen wachsenden Kontext. Bei 50 Kanälen und mehreren aktiven Nutzern pro Kanal kann das Gateway Hunderte Gesprächszustände gleichzeitig verwalten. Diese Kontextverwaltung erfolgt automatisch – alte Gespräche werden anhand konfigurierbarer TTL-Einstellungen entfernt. ## Einfügen von Skills und Verwaltung von System-Prompts Das Skill-System von OpenClaw fügt bei jeder Anfrage Anweisungen für bestimmte Fähigkeiten in den System-Prompt ein. Skills werden als Textdateien im Skills-Verzeichnis definiert und können bestimmten Kanälen zugewiesen oder global angewendet werden. Jeder Skill ergänzt Kontext, der Claude hilft, dem Zweck des jeweiligen Kanals entsprechend zu antworten – etwa mit dem Ton eines Kundensupports, im Stil technischer Dokumentation oder mit spezifischem Fachwissen. Jeder Skill fügt jeder Anfrage auf jedem Kanal, dem er zugewiesen ist, Tokens hinzu. Ein Kanal mit fünf aktiven Skills kann dem System-Prompt jeder Anfrage 2,000-5,000 Tokens hinzufügen, noch bevor ein Gesprächsverlauf enthalten ist. Über fünfzig Kanäle mit unterschiedlichen Skill-Konfigurationen hinweg ist der gesamte tägliche Zusatzaufwand durch Skills erheblich. Bei unbegrenzter Nutzung spielt das keine Rolle – schreiben Sie umfassende Skills, ohne sich um die Kosten pro Anfrage zu sorgen. Skills können über Vorlagenvariablen dynamische Inhalte enthalten. OpenClaw unterstützt das Einfügen von Nutzerinformationen, Kanalkontext, Tageszeit und benutzerdefinierten Variablen in den Skill-Text. Dieses dynamische Einfügen erfolgt zum Zeitpunkt der Anfrage und stellt sicher, dass Skills stets aktuelle Informationen enthalten. Diese Flexibilität ermöglicht differenziertes Verhalten für jeden Kanal ohne komplexe Routing-Logik. ## Kanalkonfiguration und Skalierung Jeder Kanal in OpenClaw wird im Abschnitt channels von openclaw.json oder in separaten Kanalkonfigurationsdateien konfiguriert. Ein Kanaleintrag legt den Plattformtyp (telegram, discord, slack, web, custom), die Zugangsdaten für diese Plattform, das zu verwendende Modell, die zugewiesenen Skills und die Einstellungen zur Gesprächsverwaltung (Verlaufslänge, TTL, Persona) fest. Die Skalierung ist linear: Jeder neue Kanal fügt einen weiteren offenen Inferenz-Endpunkt hinzu. Ein zusätzlicher Telegram-Bot fügt einen Kanal hinzu. Ein zusätzlicher Discord-Server mit mehreren überwachten Kanälen kann zehn hinzufügen. Jeder überwachte Discord-Kanal ist ein separater Gesprächsstrom mit eigenständigem Kontext. Eine große OpenClaw-Bereitstellung mit Discord, Telegram, Slack und Web-Widgets kann leicht 50-100 aktive Inferenz-Endpunkte haben. Bei tokenbasierter Abrechnung steigen die Kosten direkt mit der Anzahl der Kanäle. Jeder neue Kanal verursacht zusätzliche API-Kosten proportional zu seinem Nachrichtenvolumen. Mit unbegrenzter Nutzung können Sie die Anzahl der Kanäle innerhalb der Fair-Use-Ratenlimits frei erhöhen. Fügen Sie neue Plattformen, neue Bots und neue Widgets hinzu – der Pauschalpreis deckt sie alle ab. Die einzige Einschränkung ist das Ratenlimit pro Minute, das für die meisten Bereitstellungen mit mehreren Kanälen ausreichend großzügig ist. ## Fehlerbehebung bei OpenClaw-Bereitstellungen Der häufigste Konfigurationsfehler ist, api: 'anthropic-messages' in den Modelleinträgen zu vergessen. Ohne dieses Feld sendet OpenClaw Anfragen im falschen Format und erhält unverständliche Fehlermeldungen von der API. Wenn Fehler beim Parsen von Antworten oder unerwartete 400-Fehler auftreten, prüfen Sie zuerst das api-Feld. Es muss ausdrücklich gesetzt werden – für Claude-Modelle gibt es keinen korrekten Standardwert. Wenn bestimmte Kanäle fehlschlagen, während andere funktionieren, liegt das meist daran, dass die Modellzuweisung auf Kanalebene auf einen Modelleintrag verweist, der nicht existiert oder einen Tippfehler enthält. OpenClaw prüft Modellverweise beim Start nicht – der Fehler tritt erst bei einer Anfrage auf, wenn der Kanal versucht, das falsch konfigurierte Modell zu verwenden. Prüfen Sie, ob der Modellverweis jedes Kanals exakt mit dem Namen eines vorhandenen models.models-Eintrags übereinstimmt. Bei Ratenlimit-Fehlern unter hoher Last durch mehrere Kanäle sollten Sie beachten, dass alle Kanäle denselben API-Schlüssel und dieselben Ratenlimits teilen. Wenn zu Spitzenzeiten fünfzig Kanäle gleichzeitig aktiv sind, kann die gesamte Anfragerate die Fair-Use-Limits überschreiten. Das Gateway verarbeitet 429-Antworten, indem es Anfragen in eine Warteschlange stellt und erneut versucht. Das erhöht die Latenz, führt aber nicht zum Verlust von Nachrichten. Für Bereitstellungen mit sehr hohem Volumen wenden Sie sich an AI Prime Tech, um höhere Ratenkontingente zu besprechen. Kopieren ``` // ~/.openclaw/openclaw.json { "models": { "providers": { "unlimited": { "api": "anthropic-messages", "baseUrl": "https://aiprimetech.io", "apiKey": "${UNLIMITED_API_KEY}" } }, "models": { "sonnet": { "provider": "unlimited", "model": "claude-sonnet-4-5" }, "opus": { "provider": "unlimited", "model": "claude-opus-4-6" }, "haiku": { "provider": "unlimited", "model": "claude-haiku-4-5" } } }, "server": { "port": 18789 } } # IMPORTANT: api: "anthropic-messages" is REQUIRED # Without it, OpenClaw uses wrong request format ``` ## Häufig gestellte Fragen Warum muss ich api ausdrücklich auf anthropic-messages setzen? OpenClaw verwendet standardmäßig kein bestimmtes API-Format. Ohne api: 'anthropic-messages' nutzt es ein generisches Completion-Format, das mit der Messages API von Claude inkompatibel ist. Das führt zu fehlgeschlagenen Anfragen, die wie Verbindungsfehler aussehen, tatsächlich aber durch nicht übereinstimmende Formate verursacht werden. Setzen Sie den Wert für jeden Claude-Modelleintrag immer ausdrücklich. Wie viele Kanäle kann OpenClaw bei unbegrenzter Nutzung verarbeiten? Auf Gateway-Seite gibt es kein festes Kanallimit. Die praktische Einschränkung ist das Fair-Use-Ratenlimit – alle Kanäle teilen sich einen API-Schlüssel. Die meisten Bereitstellungen mit 50-100 Kanälen bleiben bei normaler Nutzung deutlich innerhalb der Limits. Bei Lastspitzen stellt das Gateway überschüssige Anfragen in eine Warteschlange und versucht sie erneut, nachdem das Ratenlimit-Zeitfenster zurückgesetzt wurde. Verwaltet jeder Kanal einen separaten Gesprächsverlauf? Ja. Jeder Kanal und jeder Nutzer innerhalb eines Kanals hat einen eigenständigen Gesprächskontext. Das Gateway verwaltet alle Verläufe im Arbeitsspeicher mit konfigurierbarer TTL. Eine Bereitstellung mit 50 Kanälen und mehreren Nutzern pro Kanal verwaltet Hunderte gleichzeitiger Gesprächszustände. Kann ich für den API-Schlüssel die Interpolation von Umgebungsvariablen verwenden? Ja. Setzen Sie apiKey in openclaw.json auf '${ENV_VAR_NAME}', dann löst OpenClaw den Wert beim Start aus der Prozessumgebung auf. So bleiben Geheimnisse außerhalb der Konfigurationsdateien – nützlich für Docker-Bereitstellungen, bei denen Geheimnisse über die Umgebung eingebunden werden. Was passiert, wenn der Gateway-Prozess abstürzt? Alle Kanäle werden getrennt, und bis zum Neustart gehen Nachrichten verloren. Verwenden Sie systemd (Restart=always) oder Docker (restart: unless-stopped), um eine automatische Wiederherstellung sicherzustellen. Gesprächsverläufe, die nur im Arbeitsspeicher gespeichert sind, gehen bei einem Absturz verloren – aktivieren Sie für wichtige Bereitstellungen die persistente Speicherung auf Datenträger oder in Redis. Claude in wenigen Minuten nutzen Holen Sie sich einen API-Schlüssel – ohne Anthropic-Konto oder Warteliste.[API-Schlüssel erhalten](/register) AI Prime Tech ist ein unabhängiges API-Gateway. Es ist weder mit Anthropic verbunden noch von Anthropic empfohlen und auch kein Wiederverkäufer von Anthropic. Claude und zugehörige Modellnamen sind Marken ihrer jeweiligen Inhaber. ## Weitere Anleitungen zur Claude API [So erhalten Sie einen Claude-API-Schlüssel](/de/learn/how-to-get-a-claude-api-key/)[Claude-API-Preise erklärt](/de/learn/claude-api-pricing-explained/)[Die günstigste Möglichkeit, die Claude API zu nutzen](/de/learn/cheapest-way-to-use-claude-api/)[Cursor unbegrenzt mit der Claude API nutzen](/learn/use-claude-api-with-cursor/)[Unbegrenzter Zugang zu Claude Code](/de/learn/use-claude-api-with-claude-code/)[Claude API-Gateway vs. direkter Zugang zu Anthropic](/de/learn/claude-api-vs-anthropic-direct/)[Claude mit dem OpenAI SDK verwenden: OpenAI-kompatibler Endpunkt, Streaming, Tools und Limits](/de/learn/openai-compatible-claude-api/)[Claude-Modelle erklärt: ein Vergleich von Claude Opus, Sonnet, Haiku und Fable — alle Claude-API-Modelle, Anthropic-Modellnamen und Preise (2026)](/de/learn/claude-api-models-compared/)[Die Claude API mit Kryptowährungen bezahlen](/de/learn/claude-api-with-crypto-payment/)[Zugang zur Claude API ohne Warteliste](/de/learn/claude-api-without-waitlist/)[So reduzieren Sie den Token-Verbrauch von Claude](/de/learn/how-to-reduce-claude-token-usage/)[Cline unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-cline/)[Roo Code unbegrenzt mit der Claude API nutzen](/de/learn/use-claude-api-with-roo-code/)[Claude unbegrenzt in JetBrains-IDEs nutzen](/de/learn/use-claude-api-with-jetbrains/)[Aider mit Claude über ein Gateway: ANTHROPIC_API_BASE, Konfigurationsdateien, Architektenmodus und Fehlerbehebungen](/de/learn/use-claude-api-with-aider/)[Claude unbegrenzt in VS Code nutzen](/de/learn/use-claude-api-with-vscode/)[OpenCode-Konfiguration für Claude: Einrichtung von opencode.json, Modelle und häufige Fehler](/de/learn/use-claude-api-with-opencode/)[Hermes Agent mit Claude über ein Gateway: Einrichtung eines benutzerdefinierten Anbieters, Kostenkontrolle und Fehlerbehebungen](/de/learn/run-hermes-agent-with-claude-api/)[Was eine Anthropic-kompatible API bedeutet](/de/learn/anthropic-compatible-api/)[Claude Code-API-Schlüssel — ANTHROPIC_API_KEY: So erhalten und konfigurieren Sie ihn, und wann Sie stattdessen claude setup-token verwenden sollten](/de/learn/claude-code-api-key-setup/)[Claude Code-API-Kosten — Preise und Möglichkeiten zur Kostensenkung](/de/learn/claude-code-api-costs/)[Claude API-Fehler erklärt: Serverfehler 500, Überlastung 529, Ratenlimit 429, fehlerhafte Anfrage 400 — und die jeweilige Lösung](/de/learn/claude-api-errors-troubleshooting/)[So kaufen Sie Claude API-Guthaben](/de/learn/buy-claude-api-credits/)[Kostenlose Claude API: Gibt es einen kostenlosen Claude API-Schlüssel, und was ist in 2026 tatsächlich kostenlos?](/de/learn/claude-api-free-trial/)[Claude API vs. Claude Pro/Max-Abonnement — welche Option wählen?](/de/learn/claude-api-vs-subscription/)[Codex CLI mit einem benutzerdefinierten Anbieter: config.toml, GPT- und Claude-Modelle, IDE-Erweiterung und Fehlerbehebungen](/de/learn/use-claude-api-with-codex/)[Claude mit n8n verbinden](/de/learn/use-claude-api-with-n8n/)[LiteLLM-Anfragen an Claude weiterleiten](/de/learn/use-claude-api-with-litellm/)[Claude in Kilo Code verwenden](/de/learn/use-claude-api-with-kilo-code/)[GitHub Copilot Chat mit Claude über ein Gateway: Einrichtung von Custom Endpoint, Agentenmodus und Fehlerbehebungen](/de/learn/use-claude-api-with-github-copilot/)[Zed über das Gateway mit Claude verbinden](/de/learn/use-claude-api-with-zed/)[Cherry Studio mit Claude verbinden](/de/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic in LangChain: Import, base_url, Streaming, Tools und Fehler](/de/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: installieren, base_url setzen, streamen und Fehler behandeln](/de/learn/anthropic-python-sdk/)[Claude mit dem Vercel AI SDK: createAnthropic baseURL, Streaming und Fehlerbehebung](/de/learn/use-claude-api-with-vercel-ai-sdk/)[Factory Droid mit Claude betreiben](/de/learn/use-claude-api-with-factory-droid/)[Die Claude Code API erklärt](/de/learn/claude-code-api/)[Die Claude API in Ihre Anwendung integrieren](/de/learn/claude-api-integration/)[So erhalten Sie unbegrenzte Claude-Nutzung](/de/learn/get-unlimited-claude-usage/)[Was unbegrenzter Zugriff auf die Claude API bedeutet](/de/learn/unlimited-claude-api-access/)