OpenClaw mit DeepSeek: Einrichtung, Modell-IDs und API-Kosten

OpenClaw erreicht DeepSeek über ein offizielles Provider-Plugin, das separat installiert wird — openclaw plugins install @openclaw/deepseek-provider —, mit der Provider-ID deepseek, dem Schlüssel DEEPSEEK_API_KEY, einer OpenAI-kompatiblen API und der Basis-URL https://api.deepseek.com, die kein /v1 enthält. Zwei Fakten entscheiden darüber, ob dein erster Lauf funktioniert. DeepSeeks aktueller Katalog umfasst zwei IDs, deepseek-flash und deepseek-v4-pro; die in älteren Anleitungen verwendeten Namen deepseek-chat und deepseek-reasoner wurden am 24. Juli 2026 eingestellt. Außerdem legt das Onboarding von OpenClaw deepseek/deepseek-v4-pro als Standard fest – genau das Modell, bei dessen aktueller Abrechnung die eigenen Seiten von DeepSeek widersprüchliche Angaben machen.

Eine Klarstellung vor der Konfiguration, da die Suchergebnisse diese beiden Projekte vermischen. Ein anderes OpenClaw auf GitHub bezeichnet sich als „eine plattformübergreifende C++-Neuimplementierung des Plattformspiels Captain Claw (1997)“; nichts davon ist hier relevant. Der Agent ist das Projekt unter openclaw.ai, dokumentiert unter docs.openclaw.ai – verlinke diesen Host, da documentation.openclaw.ai lediglich dorthin weiterleitet.

Installiere und konfiguriere es so, wie es beide Projekte dokumentieren

# 1. Install the provider plugin — DeepSeek support is not bundled.
openclaw plugins install @openclaw/deepseek-provider

# 2. Interactive: prompts for the key, sets deepseek/deepseek-v4-pro as default.
openclaw onboard --auth-choice deepseek-api-key

# 2b. Or scripted, with the flags OpenClaw documents for a headless install.
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk

Nach der Installation des Plugins gibst du keine Basis-URL an: Das Plugin stellt seinen eigenen Katalog und sein eigenes Kompatibilitätsverhalten bereit. Eine minimale Konfiguration besteht aus Schlüssel und Modell, in JSON5.

{
  env: { vars: { DEEPSEEK_API_KEY: "sk-..." } },
  agents: {
    defaults: {
      model: { primary: "deepseek/deepseek-v4-pro" },
    },
  },
}

OpenClaw löst einen Provider-Schlüssel anhand von vier Formen von Umgebungsvariablen in einer dokumentierten Prioritätsreihenfolge auf: OPENCLAW_LIVE_DEEPSEEK_KEY als einzelne aktive Überschreibung mit höchster Priorität, dann DEEPSEEK_API_KEYS als durch Komma oder Semikolon getrennte Liste, anschließend DEEPSEEK_API_KEY als primärer Schlüssel und danach nummerierte Einträge DEEPSEEK_API_KEY_* (Control UI and keys, geprüft am 21. September 2026). „Settings“ und anschließend „Models“ in der Steueroberfläche fügt Schlüssel hinzu oder ersetzt sie, ohne die Datei zu bearbeiten; das Schlüsselmaterial bleibt im Auth-Speicher. Die Falle bei einer Serverinstallation betrifft den Geltungsbereich, nicht die Schreibweise: OpenClaws eigene Seite weist darauf hin, dass der Schlüssel, wenn das Gateway als Daemon unter launchd oder systemd läuft, für diesen Prozess sichtbar sein muss, etwa in ~/.openclaw/.env oder über env.shellEnv.

Welche DeepSeek-Modell-IDs tatsächlich aktiv sind

Die folgenden Zeilen haben drei verschiedene Status statt nur eines. Die Beispielantwort in DeepSeeks list-models-Referenz zeigt genau zwei IDs, deepseek-flash und deepseek-v4-pro, während der mit OpenClaw gebündelte Katalog weiterhin vier Referenzen anbietet.

Halte die beiden Aussagen zur Einstellung getrennt, da sie widersprüchlich wirken und es nicht sind. OpenClaw erklärt, dass DeepSeek deepseek-chat und deepseek-reasoner eingestellt habe und dass „diese Modell-IDs nicht mehr zugänglich sind“. DeepSeek erklärt separat, dass „die alten Namen deepseek-v4-flash und deepseek-v4-flash-vision-exp weiterhin akzeptiert werden, die entsprechenden Modelle jedoch eingestellt wurden“. Zwei unterschiedliche Namenspaare, zwei unterschiedliche Ergebnisse. DeepSeeks Seite „Models & Pricing“ nennt für beide aktiven IDs eine Kontextlänge von 1M und eine maximale Ausgabe von 384K; OpenClaws Katalogtabelle führt dasselbe Paar 1.000.000 / 384.000 für alle vier Referenzen.

Der ungeklärte Fall. DeepSeeks Ankündigung vom 10. September 2026 sagt: „Wir stellen V4-Pro schrittweise ein“ und „ab 04:00 UTC am 14. September 2026 werden alle Anfragen an deepseek-v4-pro zu V4.1-Flash weitergeleitet und zu den V4.1-Flash-Tarifen abgerechnet“. Das Änderungsprotokoll derselben Veröffentlichung sagt das Gegenteil: „Als Reaktion auf die Nachfrage der Nutzer haben wir beschlossen, nach dem 14. September 2026 weiterhin API-Dienste für DeepSeek V4 Pro bereitzustellen, wobei die Abrechnungsmethode unverändert bleibt.“ Die Seite „Models & Pricing“ führt V4 Pro weiterhin mit eigenen höheren Tarifen und enthält keinen Hinweis auf eine Einstellung. Beide Seiten wurden am 21. September 2026 gelesen, eine Woche nach dem fraglichen Datum. Diese Seite sagt dir nicht, welche Abrechnung gilt – bestätige dies in deinem eigenen DeepSeek-Konto, bevor du den Onboarding-Standard beibehältst, und beachte, dass genau dieses Modell umstritten ist.

Was die Tokens kosten und warum die Uhrzeit Teil des Preises ist

DeepSeek veröffentlicht Tarife für Spitzen- und Nebenzeiten, wobei Nebenzeiten halb so teuer wie Spitzenzeiten sind. Das Zeitfenster ist eng: „Spitzenzeiten sind montags bis freitags von 01:00–04:00 und 06:00–10:00 UTC, ausgenommen chinesische gesetzliche Feiertage. Alle anderen Zeiten sind Nebenzeiten, einschließlich Wochenenden und chinesischer gesetzlicher Feiertage vollständig.“ Sieben Stunden an Werktagen sind Spitzenzeit, alles andere nicht; eine Schätzung, die stillschweigend Spitzenzeit annimmt, überschätzt daher eine typische Rechnung.

Gelesen auf DeepSeeks Seite „Models & Pricing“ am 21. September 2026. Die Flash-Zeile wird unabhängig durch OpenClaws Provider-Seite bestätigt, die „$0.30 pro Million Eingabetokens, $1.20 pro Million Ausgabetokens und $0.006 pro Million zwischengespeicherten Eingabetokens“ nennt. Die V4-Pro-Zeilen beruhen ausschließlich auf der Seite „Models & Pricing“ und stehen unter dem oben beschriebenen Widerspruch; behandle sie daher als zitierte, nicht als endgültig geklärte Angaben.

Die Cache-Spalte ist diejenige, die die Agentenrechnung verändert, und ihr Verhältnis ist ungewöhnlich. Ein Cache-Treffer bei deepseek-flash kostet $0.006 pro Million gegenüber $0.30 bei einem Fehltreffer – ungefähr ein Fünfzigstel der Fehltreffer-Rate und deutlich weniger als das andernorts übliche Verhältnis von einem Zehntel. Übertrage daher keine Annahme von einem anderen Anbieter. DeepSeeks Caching-Anleitung sagt, dass die Funktion „standardmäßig für alle Nutzer aktiviert ist, ohne dass der Code geändert werden muss“, dass ein Treffer ein vollständig übereinstimmendes Präfix erfordert und dass ein ungenutzter Cache „normalerweise innerhalb einiger Stunden bis weniger Tage“ gelöscht wird. Treffer und Fehltreffer erscheinen in den Nutzungsfeldern prompt_cache_hit_tokens und prompt_cache_miss_tokens. DeepSeek veröffentlicht keinen Preis für das Schreiben in den Cache, und seine Preistabelle enthält keine entsprechende Spalte; das bedeutet, dass keine veröffentlichte Gebühr existiert, nicht, dass Schreibvorgänge kostenlos sind.

Eine beispielhafte Sitzung mit deepseek-flash zu den veröffentlichten DeepSeek-Tarifen. Angenommen, ein OpenClaw-Lauf sendet 600.000 Eingabetokens, davon 450.000 mit Präfix-Cache-Treffer und 150.000 ohne Treffer, und empfängt 40.000 Ausgabetokens. Zur Spitzenzeit sind das $0.045 plus $0.0027 plus $0.048, also $0.096; dieselbe Sitzung kostet außerhalb der Spitzenzeit $0.048. Derselbe Lauf ohne jegliche Cache-Treffer würde zur Spitzenzeit $0.228 kosten. Dies ist Token-Arithmetik unter den genannten Annahmen, keine gemessenen Aufgabenkosten und keine Ausgabenobergrenze – der eigene Anteil an Cache-Treffern ist die wichtigste Variable. Die anwendungsinterne Zahl von OpenClaw klärt dies nicht, da OpenClaw seine lokalen Kosten als Schätzungen bezeichnet und DeepSeeks Preisseite als maßgeblich für die Abrechnung nennt.

Modellfunktionen und Tool-Unterstützung des Clients sind zwei verschiedene Fragen

Das ist der Teil, den eine Preistabelle nicht verrät, und der praktische Grund, das Plugin statt eines selbst erstellten Provider-Eintrags zu verwenden. DeepSeek-V4-Denksitzungen erfordern bei Folgeanfragen wiedergegebene Assistant-Nachrichten aus einem denkfähigen Turn, die reasoning_content enthalten. Das DeepSeek-Plugin von OpenClaw ergänzt dieses Feld automatisch, sodass mehrstufige Tool-Nutzung „auch dann funktioniert, wenn der Verlauf von einem anderen OpenAI-kompatiblen Provider stammt (kein natives reasoning_content) oder aus einer einfachen Assistant-Nachricht“, ohne dass nach einem Provider-Wechsel mitten in der Sitzung /new erforderlich ist. Wenn Denken deaktiviert ist, einschließlich der UI-Auswahl „None“, sendet OpenClaw thinking: { type: "disabled" } und entfernt wiedergegebene reasoning_content aus dem ausgehenden Verlauf. OpenClaw ordnet außerdem sowohl /think xhigh als auch /think max dem maximalen reasoning_effort von DeepSeek zu.

Ein generischer openai-completions-Custom-Provider, der auf einen DeepSeek-kompatiblen Endpunkt zeigt, erhält keine dieser Ergänzungen und kein DeepSeek-Denkformat, sofern du den Kompatibilitätsblock nicht selbst deklarierst – OpenClaws ds4-Seite zeigt die Struktur einschließlich thinkingFormat: "deepseek" und supportsReasoningEffort. Diese Lücke erklärt normalerweise, warum ein Tool-Turn einmal erfolgreich ist und anschließend beim Folgeaufruf fehlschlägt.

Zwei Einschränkungen auf Seiten von DeepSeek gehören zur selben Entscheidung. Striktes Tool-Calling befindet sich auf einer anderen Basis-URL, https://api.deepseek.com/beta, und erfordert bei jeder Funktion "strict": true sowie "additionalProperties": false; dorthin zeigt das Plugin standardmäßig nicht. Außerdem erklärt DeepSeeks Anleitung zum Tool-Calling: „Die Chat Completion API unterstützt das Einfügen von Tool-Aufrufen mitten in einer Unterhaltung nicht, wohl aber das Einfügen von system-Nachrichten mitten in einer Unterhaltung; zum Einfügen von Tool-Aufrufen verwendest du stattdessen die Anthropic API oder die Responses API“ – eine Einschränkung des von OpenClaws Plugin verwendeten Endpunkts, mit zwei dokumentierten Alternativen statt einer Modellbeschränkung.

Bei der Modellunterstützung stimmen die beiden Quellen überein. Die Spalte FEATURES auf DeepSeeks Seite „Models & Pricing“ markiert Tool Calls, JSON Output, die Responses API und die Anthropic API für deepseek-flash und deepseek-v4-pro als unterstützt und trennt sie bei Vision – unterstützt auf deepseek-flash, nicht unterstützt auf deepseek-v4-pro. OpenClaw erklärt, dass mehrstufige Tool-Nutzung auf allen vier Referenzen funktioniert. Keine der beiden Seiten dokumentiert parallele Tool-Aufrufe; diese Frage ist daher tatsächlich offen.

Überprüfe dies in drei Schritten, danach folgen die nennenswerten Fehler

Prüfe die Ebenen in dieser Reihenfolge, da jede anders fehlschlägt. Zuerst der Katalog: openclaw models list --provider deepseek oder openclaw models list --all --provider deepseek, um den statischen Plugin-Katalog ohne laufendes Gateway zu prüfen; anschließend openclaw models set deepseek/deepseek-flash, wenn du das unbestrittene Modell statt des Onboarding-Standards verwenden möchtest. Zweitens eine kurze Anfrage ohne Streaming und danach eine mit Streaming – dabei treten Authentifizierungs- oder Basis-URL-Probleme klar zutage. Drittens und erst dann ein Tool-Aufruf gefolgt von einem zweiten Turn in derselben Sitzung; nur dieser Schritt prüft die oben beschriebene Wiedergabe von reasoning_content.

Die 404-Zeile verdient einen eigenen Satz, da die Dokumentation sie nicht für dich erklären kann. DeepSeeks Fehlercodetabelle führt 400, 401, 402, 422, 429, 500 und 503 auf und enthält keine 404. Eine 404 ist hier daher ein Hinweis auf dein Routing und nicht auf DeepSeek. Was DeepSeek bei einer unbekannten Modell-ID tatsächlich zurückgibt, ist hier undokumentiert und ungetestet. Die Fehlerreferenz behandelt die entsprechenden Statuscodes auf Kunavos eigenem Endpunkt.

Direkt, Gateway, lokal: Welche Route gewinnt

Kunavo stellt kein DeepSeek-Modell bereit. Seine Textmodelle gehören zu den Claude- und OpenAI-Familien; daher gibt es bei Kunavo keine Route zu einem DeepSeek-Modell, und diese Seite bietet auch keine an. Übertragbar ist jedoch der Mechanismus – wichtig zu wissen, wenn du diese DeepSeek-Anleitung liest, weil du einen Schlüssel für mehrere Modellfamilien statt speziell für DeepSeek verwenden möchtest.

Für die Gateway-Zeile besteht die Konfiguration aus denselben zwei Stellschrauben. Entweder deklarierst du models.providers.<id> mit baseUrl, apiKey, api: "openai-completions" und einem models[]-Array, das mindestens jede id aufführt, oder du führst das Onboarding gegen den Endpunkt mit --auth-choice custom-api-key, --custom-base-url und --custom-model-id durch. Modellreferenzen haben immer das Format provider/model. Ein stiller Fehler besteht darin, ein Modell unter agents.defaults.models als Alias zu definieren, ohne es in models.providers.<provider>.models[] zu registrieren – OpenClaws Referenz für benutzerdefinierte Provider erklärt, dass der Alias „weder Überschreibungen beschränkt noch selbst ein neues Laufzeitmodell registriert“. Kunavos Basis-URL für diese Route ist https://api.kunavo.com/v1 mit genau einem /v1 – das Gegenteil von DeepSeeks Konvention ohne Suffix und die wahrscheinlichste Ursache für eine 404, wenn jemand den Wert der einen Seite in das Feld der anderen kopiert.

Zur Einordnung der Größenordnung dieser Alternative folgt hier dieselbe angenommene Sitzungsform – 600.000 Eingabetokens und 40.000 Ausgabetokens ohne angenommenen Cache –, bewertet zu den aktuellen Tarifen des Kunavo-Katalogs. Dies sind andere Modelle an einem anderen Endpunkt; daher handelt es sich um einen Formvergleich und nicht um einen Kostenvergleich für dieselbe Aufgabe mit den obigen DeepSeek-Zahlen. Der günstigste aufgeführte Tarif und die niedrigsten Kosten zum Abschluss einer Aufgabe sind getrennte Aussagen; nur dein eigener Lauf klärt die zweite.

Beispielhafte Token-Arithmetik unter den genannten Annahmen, keine gemessenen Aufgabenkosten und keine Rechnungsobergrenze. Der Katalogbetrag von Kunavo ist eine Abrechnungsuntergrenze statt einer Obergrenze: Wenn der Upstream seine Kosten meldet, entspricht die Rechnung dem höheren Wert aus den Katalogkosten und den Upstream-Kosten multipliziert mit dem anwendbaren Aufschlag. Cache-Gebühren und externe Tools liegen außerhalb dieses Beispiels. Die minimale Aufladung beträgt $10 an vorausbezahltem Guthaben – ein Finanzierungsminimum, keine Aufgaben- oder Abonnementgebühr. Siehe Abrechnungsdetails und Caching.

Wenn du tatsächlich diese benachbarte Route möchtest, beginne mit der Integrationsübersicht für Basis-URL und Schlüsseleinrichtung, anschließend mit dem Quickstart für einen ersten Aufruf und mit Kunavo-Konto erstellen, sobald du einen Schlüssel aufladen möchtest. Betrachte dies als veröffentlichte Konfigurationsreferenz, nicht als Kompatibilitätsergebnis: OpenClaw wurde mit Kunavos Endpunkt nicht zur Laufzeit getestet. Bleibst du bei OpenClaw und möchtest stattdessen ein Modell auswählen? OpenClaw-Preise trennt die kostenlose Software von der nutzungsabhängigen Rechnung, Beste API für OpenClaw vergleicht Routen nach Aufgabe und OpenAI-kompatible API behandelt die Basis-URL-Konventionen, vor denen diese Seite wiederholt warnt.

Häufig gestellte Fragen

Jede OpenClaw- und DeepSeek-Aussage oben wurde am 21. September 2026 anhand der eigenen Dokumentation und Register dieser Projekte gelesen, gegenüber OpenClaw v2026.9.5. Für diese Seite wurden die Provider-Seite, die Preisseite, das Änderungsprotokoll, die Ankündigung vom 10. September, die List-Models-Referenz, die Fehlercodetabelle, die Seite zum Ratenlimit und die Regeln für benutzerdefinierte Provider jeweils direkt erneut abgerufen. Nichts wurde installiert, einem Onboarding unterzogen oder aufgerufen: kein OpenClaw-Lauf, keine Anfrage an api.deepseek.com und kein Laufzeittest gegen Kunavo. Kunavos Token-Tarife stammen aus dem aktuellen Katalog, und jeder Dollarbetrag ist beispielhafte Token-Arithmetik statt gemessener Kosten.