API-Nutzung und Kosten

Übersicht der OpenClaw-Funktionen, die kostenpflichtige Provider-APIs aufrufen können, wo sie jeweils ihre Anmeldedaten lesen und wo die daraus entstehenden Kosten angezeigt werden.

Wo Kosten angezeigt werden

/status (Snapshot pro Sitzung)

• Zeigt das aktuelle Sitzungsmodell, die Kontextnutzung und die Token der letzten Antwort an.
• Fügt für die letzte Antwort geschätzte Kosten hinzu, wenn OpenClaw über Nutzungsmetadaten und lokale Preisinformationen für das aktive Modell verfügt. Dies schließt ausdrücklich bepreiste Provider ohne API-Schlüssel ein, etwa Bedrock-aws-sdk-Modelle.
• Wenn der Live-Sitzungs-Snapshot nur wenige Daten enthält, stellt /status Token-/Cache-Zähler und die Bezeichnung des aktiven Modells aus dem neuesten Nutzungseintrag des Transkripts wieder her. Vorhandene Live-Werte ungleich null haben Vorrang vor Transkriptdaten; eine der Prompt-Größe entsprechende Transkript-Gesamtsumme kann dennoch Vorrang haben, wenn die gespeicherte Gesamtsumme fehlt oder kleiner ist.

/usage (Fußzeile pro Nachricht)

• /usage full hängt an jede Antwort eine Nutzungsfußzeile an, einschließlich geschätzter Kosten, wenn lokale Preisinformationen konfiguriert und Nutzungsmetadaten verfügbar sind.
• /usage tokens zeigt nur Token an. Abonnementbasierte OAuth-/Token- und CLI-Runtimes zeigen nur Token an, sofern sie nicht kompatible Nutzungsmetadaten sowie einen expliziten lokalen Preis bereitstellen.
• /usage cost gibt eine lokale Kostenübersicht aus; /usage off deaktiviert die Fußzeile.
• Hinweis zur Gemini CLI: Sowohl die Ausgabe von stream-json als auch die ältere Ausgabe von json enthält Nutzungsdaten unter stats. OpenClaw normalisiert stats.cached in cacheRead und leitet bei Bedarf die Eingabe-Token aus stats.input_tokens - stats.cached ab.

Control UI → Nutzung (sitzungsübergreifende Analyse)

• Zeigt aus Transkripten abgeleitete Token-Gesamtsummen und geschätzte Gesamtkosten für den ausgewählten Datumsbereich an, aufgeschlüsselt nach Provider, Modell, Agent, Kanal und Token-Typ.
• Vergleicht kürzere Kalenderzeiträume, die am Enddatum des ausgewählten Bereichs enden. Fehlende Datumsangaben zählen als Kalendertage ohne Nutzung; sie werden nicht übersprungen, um einen dichteren Zeitraum zu erzeugen.
• Beschriftet die Skalierung des Tagesdiagramms direkt. Ein √-Badge bedeutet, dass eine Quadratwurzelkompression Tage mit geringer Nutzung sichtbar hält.
• Diese Gesamtsummen beschreiben den verfügbaren lokalen Sitzungsverlauf, nicht eine Provider-Rechnung oder ein Abrechnungsprotokoll über die gesamte Nutzungsdauer. Die Benutzeroberfläche warnt, wenn für einige Einträge Preisinformationen fehlen.

CLI-Nutzungszeiträume (Provider-Kontingente, keine Kosten pro Nachricht)

• openclaw status --usage und openclaw channels list zeigen Nutzungszeiträume des Providers als X% left an.
• Aktuelle Provider für Nutzungszeiträume: Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (umfasst ChatGPT/Codex-OAuth-/Token-Authentifizierung), Xiaomi und z.ai. Die vollständige Liste der Provider und Flags finden Sie unter Modell-CLI und Kanal-CLI.
• Die Rohfelder usage_percent / usagePercent von MiniMax geben das verbleibende Kontingent an, daher kehrt OpenClaw sie um; zählerbasierte Felder haben Vorrang, sofern vorhanden. Wenn die Antwort ein model_remains-Array enthält, wählt OpenClaw den Eintrag des Chatmodells aus, leitet bei Bedarf die Bezeichnung des Zeitraums aus Zeitstempeln ab und nimmt den Modellnamen in die Planbezeichnung auf.
• Die Nutzungsauthentifizierung stammt aus providerspezifischen Hooks, sofern verfügbar; andernfalls greift OpenClaw auf passende OAuth-/API-Schlüssel-Anmeldedaten aus Authentifizierungsprofilen, Umgebungsvariablen oder der Konfiguration zurück.

Ausführliche Beispiele finden Sie unter Token-Nutzung und Kosten.

So werden Schlüssel gefunden

• Authentifizierungsprofile: pro Agent, gespeichert in auth-profiles.json.
• Umgebungsvariablen: beispielsweise OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY.
• Konfiguration: models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memory.search.*, talk.providers.*.apiKey.
• Skills: skills.entries.<name>.apiKey, wodurch der Schlüssel möglicherweise in die Prozessumgebung des Skills exportiert wird.

Funktionen, die Schlüssel kostenpflichtig nutzen können

Antworten des Kernmodells (Chat + Tools)

Jede Antwort und jeder Tool-Aufruf wird über den aktuellen Modell-Provider ausgeführt. Dies ist die Hauptquelle für Nutzung und Kosten, einschließlich abonnementbasierter gehosteter Tarife, deren Abrechnung außerhalb der lokalen Benutzeroberfläche von OpenClaw erfolgt: OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan und der Claude-Anmeldepfad von Anthropic mit aktivierter Option Extra Usage.

Informationen zur Preiskonfiguration finden Sie unter Modelle, Informationen zur Anzeige unter Token-Nutzung und Kosten.

Medienanalyse (Audio/Bild/Video)

Eingehende Medien können über eine Provider-API zusammengefasst oder transkribiert werden, bevor die Antwort-Pipeline ausgeführt wird. Die Provider-Unterstützung wird pro Plugin registriert und ändert sich, wenn Plugins hinzugefügt werden; die aktuelle Liste und Konfiguration finden Sie unter Medienanalyse.

Bild- und Videogenerierung

image_generate und video_generate leiten Anfragen an einen verfügbaren authentifizierten Provider weiter. Beide können einen durch Authentifizierung gestützten Standard-Provider ableiten, wenn ihr Eintrag agents.defaults.mediaModels nicht festgelegt ist.

Die aktuelle Provider-Liste finden Sie unter Bildgenerierung und Videogenerierung.

Speicher-Embeddings und semantische Suche

Die semantische Speichersuche verwendet Embedding-APIs, wenn memory.search.provider einen Remote-Adapter bezeichnet (zum Beispiel openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). memory.search.provider = "lmstudio" oder "ollama" wird auf einem lokalen bzw. selbst gehosteten Server ausgeführt und verursacht üblicherweise keine Kosten für gehostete Dienste. memory.search.provider = "local" belässt alles auf dem Gerät, ohne API-Nutzung. Ein optionaler memory.search.fallback-Provider kann Ausfälle lokaler Embeddings abdecken.

Siehe Speicher.

Websuch-Tool

web_search kann abhängig vom ausgewählten Provider Nutzungskosten verursachen. Jeder Provider liest seinen Schlüssel zunächst aus einer Umgebungsvariablen und anschließend aus plugins.entries.<id>.config.webSearch.apiKey:

Ältere tools.web.search.*-Konfigurationspfade werden weiterhin über einen Kompatibilitäts-Shim geladen, sind jedoch nicht mehr die empfohlene Oberfläche.

Kostenloses Guthaben von Brave Search: Jeder Tarif enthält ein monatlich erneuertes kostenloses Guthaben von $5. Der Search-Tarif kostet $5 pro 1,000 Anfragen, sodass das Guthaben 1,000 Anfragen pro Monat kostenlos abdeckt. Legen Sie im Brave-Dashboard ein Nutzungslimit fest, um unerwartete Kosten zu vermeiden.

Siehe Web-Tools.

Webabruf-Tool (Firecrawl)

web_fetch kann Firecrawl mit einem schlüssellosen Starterzugang aufrufen; fügen Sie FIRECRAWL_API_KEY (oder plugins.entries.firecrawl.config.webFetch.apiKey) hinzu, um höhere Limits zu erhalten. Wenn Firecrawl nicht konfiguriert ist, greift das Tool auf direkten Abruf sowie das mitgelieferte web-readability-Plugin zurück (keine kostenpflichtige API). Deaktivieren Sie plugins.entries.web-readability.enabled, um die lokale Readability-Extraktion zu überspringen.

Siehe Web-Tools.

Provider-Nutzungs-Snapshots (Status/Funktionsfähigkeit)

openclaw status --usage und openclaw models status --json rufen Provider-Nutzungsendpunkte auf, um Kontingentzeiträume oder den Authentifizierungsstatus anzuzeigen. Die Anzahl der Aufrufe ist gering, sie greifen jedoch dennoch auf Provider-APIs zu.

Siehe Modell-CLI.

Schutzmechanismus zur Zusammenfassung bei der Compaction

Der Compaction-Schutzmechanismus kann den Sitzungsverlauf mithilfe des aktuellen Modells zusammenfassen und ruft bei seiner Ausführung Provider-APIs auf.

Siehe Sitzungsverwaltung und Compaction.

Modellscan/-prüfung

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

Siehe Modell-CLI.

Sprechen (Sprachausgabe)

Der Sprechmodus kann ElevenLabs aufrufen, wenn Folgendes konfiguriert ist: ELEVENLABS_API_KEY oder talk.providers.elevenlabs.apiKey.

Siehe Sprechmodus.

Skills (Drittanbieter-APIs)

Skills können apiKey in skills.entries.<name>.apiKey speichern. Wenn ein Skill diesen Schlüssel für eine externe API verwendet, richten sich die Kosten nach dem Provider des Skills.

Siehe Skills.

Verwandte Themen

• Token-Nutzung und Kosten
• Prompt-Caching
• Nutzungsverfolgung