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.

// ~/.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

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.