Zum Hauptinhalt springen
DeepSeek stellt leistungsstarke KI-Modelle mit einer OpenAI-kompatiblen API bereit.
EigenschaftWert
Providerdeepseek
AuthDEEPSEEK_API_KEY
APIOpenAI-kompatibel
Basis-URLhttps://api.deepseek.com

Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie dann den Gateway neu:
openclaw plugins install @openclaw/deepseek-provider
openclaw gateway restart

Erste Schritte

1

Get your API key

Erstellen Sie einen API-Schlüssel unter platform.deepseek.com.
2

Run onboarding

openclaw onboard --auth-choice deepseek-api-key
Dadurch werden Sie zur Eingabe Ihres API-Schlüssels aufgefordert, und deepseek/deepseek-v4-flash wird als Standardmodell festgelegt.
3

Verify models are available

openclaw models list --provider deepseek
Um den statischen Katalog des Plugins zu prüfen, ohne dass ein laufender Gateway erforderlich ist, verwenden Sie:
openclaw models list --all --provider deepseek
Für skriptgesteuerte oder headless Installationen übergeben Sie alle Flags direkt:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice deepseek-api-key \
  --deepseek-api-key "$DEEPSEEK_API_KEY" \
  --skip-health \
  --accept-risk
Wenn der Gateway als Daemon ausgeführt wird (launchd/systemd), stellen Sie sicher, dass DEEPSEEK_API_KEY für diesen Prozess verfügbar ist (zum Beispiel in ~/.openclaw/.env oder über env.shellEnv).

Integrierter Katalog

Modell-RefNameEingabeKontextMaximale AusgabeHinweise
deepseek/deepseek-v4-flashDeepSeek V4 FlashText1,000,000384,000Standardmodell; V4-Oberfläche mit Thinking-Unterstützung
deepseek/deepseek-v4-proDeepSeek V4 ProText1,000,000384,000V4-Oberfläche mit Thinking-Unterstützung
deepseek/deepseek-chatDeepSeek ChatText131,0728,192DeepSeek V3.2-Oberfläche ohne Thinking
deepseek/deepseek-reasonerDeepSeek ReasonerText131,07265,536V3.2-Oberfläche mit Reasoning-Unterstützung
V4-Modelle unterstützen die thinking-Steuerung von DeepSeek. OpenClaw spielt außerdem DeepSeek-reasoning_content in Folgeturns erneut ein, damit Thinking-Sitzungen mit Tool- Aufrufen fortgesetzt werden können. Verwenden Sie /think xhigh oder /think max mit DeepSeek-V4-Modellen, um DeepSeeks maximales reasoning_effort anzufordern.

Thinking und Tools

DeepSeek-V4-Thinking-Sitzungen haben einen strengeren Replay-Vertrag als die meisten OpenAI-kompatiblen Provider: Nachdem ein Turn mit aktiviertem Thinking Tools verwendet hat, erwartet DeepSeek, dass erneut eingespielte Assistant-Nachrichten aus diesem Turn bei Folgeanfragen reasoning_content enthalten. OpenClaw verarbeitet dies innerhalb des DeepSeek-Plugins, sodass normale Tool-Nutzung über mehrere Turns hinweg mit deepseek/deepseek-v4-flash und deepseek/deepseek-v4-pro funktioniert. Wenn Sie eine bestehende Sitzung von einem anderen OpenAI-kompatiblen Provider auf ein DeepSeek-V4-Modell umstellen, haben ältere Assistant-Turns mit Tool-Aufrufen möglicherweise kein natives DeepSeek-reasoning_content. OpenClaw ergänzt dieses fehlende Feld in erneut eingespielten Assistant-Nachrichten für DeepSeek-V4-Thinking-Anfragen, damit der Provider den Verlauf akzeptieren kann, ohne /new zu erfordern. Wenn Thinking in OpenClaw deaktiviert ist (einschließlich der UI-Auswahl None), sendet OpenClaw DeepSeek thinking: { type: "disabled" } und entfernt erneut eingespieltes reasoning_content aus dem ausgehenden Verlauf. Dadurch bleiben Sitzungen mit deaktiviertem Thinking auf dem DeepSeek-Pfad ohne Thinking. Verwenden Sie deepseek/deepseek-v4-flash für den standardmäßigen schnellen Pfad. Verwenden Sie deepseek/deepseek-v4-pro, wenn Sie das stärkere V4-Modell möchten und höhere Kosten oder Latenz akzeptieren können.

Live-Tests

Die direkte Live-Modellsuite enthält DeepSeek V4 im modernen Modellset. Um nur die direkten Modellprüfungen für DeepSeek V4 auszuführen:
OPENCLAW_LIVE_PROVIDERS=deepseek \
OPENCLAW_LIVE_MODELS="deepseek/deepseek-v4-flash,deepseek/deepseek-v4-pro" \
pnpm test:live src/agents/models.profiles.live.test.ts
Diese Live-Prüfung verifiziert, dass beide V4-Modelle abschließen können und dass Thinking-/Tool- Folgeturns die von DeepSeek benötigte Replay-Nutzlast beibehalten.

Konfigurationsbeispiel

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

Verwandte Themen

Model selection

Auswahl von Providern, Modell-Refs und Failover-Verhalten.

Configuration reference

Vollständige Konfigurationsreferenz für Agents, Modelle und Provider.