API-Nutzung & Kosten

Dieses Dokument listet Features auf, die API-Keys verwenden können und wo deren Kosten sichtbar werden. Der Fokus liegt auf OpenClaw-Features, die Provider-Nutzung oder kostenpflichtige API-Aufrufe erzeugen können.

Wo Kosten angezeigt werden (Chat + CLI)

Kosten-Snapshot pro Session

  • /status zeigt das aktuelle Session-Modell, Context-Nutzung und Token der letzten Antwort.
  • Wenn das Modell API-Key-Authentifizierung nutzt, zeigt /status auch die geschätzten Kosten für die letzte Antwort.

Kosten-Footer pro Nachricht

  • /usage full fügt jeder Antwort einen Nutzungs-Footer hinzu, inklusive geschätzter Kosten (nur bei API-Key).
  • /usage tokens zeigt nur Token; bei OAuth-Flows werden Dollar-Kosten ausgeblendet.

CLI-Nutzungsfenster (Provider-Quotas)

  • openclaw status --usage und openclaw channels list zeigen Provider-Nutzungsfenster (Quota-Snapshots, keine Kosten pro Nachricht).

Details und Beispiele findest du unter Token-Nutzung & Kosten.

Wie API-Keys gefunden werden

OpenClaw kann Zugangsdaten aus folgenden Quellen beziehen:

  • Auth-Profile (pro Agent, gespeichert in auth-profiles.json).
  • Umgebungsvariablen (z. B. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
  • Config (models.providers.*.apiKey, tools.web.search.*, tools.web.fetch.firecrawl.*, memorySearch.*, talk.apiKey).
  • Skills (skills.entries.<name>.apiKey), die Keys an die Skill-Prozessumgebung exportieren können.

Features, die API-Keys verbrauchen können

1) Kern-Modellantworten (Chat + Tools)

Jede Antwort oder jeder Tool-Aufruf nutzt den aktuellen Model-Provider (OpenAI, Anthropic, etc.). Das ist die Hauptquelle für Nutzung und Kosten.

Siehe Models für Preis-Konfiguration und Token-Nutzung & Kosten für die Anzeige.

2) Media-Verarbeitung (Audio/Bild/Video)

Eingehende Medien können zusammengefasst oder transkribiert werden, bevor die Antwort läuft. Dabei werden Model-/Provider-APIs verwendet.

  • Audio: OpenAI / Groq / Deepgram (jetzt automatisch aktiviert, wenn Keys vorhanden sind).
  • Bild: OpenAI / Anthropic / Google.
  • Video: Google.

Siehe Media-Verarbeitung.

3) Memory-Embeddings + semantische Suche

Die semantische Memory-Suche nutzt Embedding-APIs, wenn sie für Remote-Provider konfiguriert ist:

  • memorySearch.provider = "openai" → OpenAI-Embeddings
  • memorySearch.provider = "gemini" → Gemini-Embeddings
  • Optionaler Fallback zu OpenAI, falls lokale Embeddings fehlschlagen

Du kannst es lokal halten mit memorySearch.provider = "local" (keine API-Nutzung).

Siehe Memory.

4) Web-Search-Tool (Brave / Perplexity via OpenRouter)

web_search verwendet API-Keys und kann Nutzungsgebühren verursachen:

  • Brave Search API: BRAVE_API_KEY oder tools.web.search.apiKey
  • Perplexity (via OpenRouter): PERPLEXITY_API_KEY oder OPENROUTER_API_KEY

Brave Free Tier (großzügig):

  • 2.000 Anfragen/Monat
  • 1 Anfrage/Sekunde
  • Kreditkarte erforderlich zur Verifizierung (keine Kosten, außer du upgradest)

Siehe Web-Tools.

5) Web-Fetch-Tool (Firecrawl)

web_fetch kann Firecrawl aufrufen, wenn ein API-Key vorhanden ist:

  • FIRECRAWL_API_KEY oder tools.web.fetch.firecrawl.apiKey

Wenn Firecrawl nicht konfiguriert ist, fällt das Tool auf direktes Fetch + Readability zurück (keine kostenpflichtige API).

Siehe Web-Tools.

6) Provider-Nutzungs-Snapshots (Status/Health)

Einige Status-Befehle rufen Provider-Nutzungs-Endpoints auf, um Quota-Fenster oder Auth-Status anzuzeigen. Das sind normalerweise wenige Aufrufe, aber sie treffen trotzdem Provider-APIs:

  • openclaw status --usage
  • openclaw models status --json

Siehe Models CLI.

7) Compaction-Safeguard-Zusammenfassung

Der Compaction-Safeguard kann die Session-Historie mit dem aktuellen Modell zusammenfassen, was Provider-APIs aufruft, wenn es läuft.

Siehe Session-Management + Compaction.

8) Model-Scan / Probe

openclaw models scan kann OpenRouter-Modelle prüfen und verwendet OPENROUTER_API_KEY, wenn Probing aktiviert ist.

Siehe Models CLI.

9) Talk (Sprache)

Der Talk-Modus kann ElevenLabs aufrufen, wenn konfiguriert:

  • ELEVENLABS_API_KEY oder talk.apiKey

Siehe Talk-Modus.

10) Skills (Drittanbieter-APIs)

Skills können apiKey in skills.entries.<name>.apiKey speichern. Wenn ein Skill diesen Key für externe APIs nutzt, können Kosten gemäß dem Provider des Skills entstehen.

Siehe Skills.