Zum Hauptinhalt springen
Dieses Dokument listet Funktionen auf, die API-Schlüssel aufrufen können, und zeigt, wo deren Kosten erscheinen. Es konzentriert sich auf OpenClaw-Funktionen, die Provider-Nutzung oder kostenpflichtige API-Aufrufe erzeugen können.

​
Wo Kosten erscheinen (Chat + CLI)

Kostensnapshot pro Sitzung
  • /status zeigt das aktuelle Sitzungsmodell, die Kontextnutzung und die Tokens der letzten Antwort.
  • Wenn OpenClaw Nutzungsmetadaten und lokale Preise für das aktive Modell hat, zeigt /status auch die geschätzten Kosten für die letzte Antwort. Dies kann ausdrücklich bepreiste Provider ohne API-Schlüssel einschließen, z. B. Bedrock-Modelle mit aws-sdk.
  • Wenn Live-Sitzungsmetadaten spärlich sind, kann /status Token-/Cache- Zähler und die Bezeichnung des aktiven Laufzeitmodells aus dem neuesten Transcript-Nutzungseintrag wiederherstellen. Bestehende Live-Werte ungleich null haben weiterhin Vorrang, und promptgroße Transcript-Summen können gewinnen, wenn gespeicherte Summen fehlen oder kleiner sind.
Kostenfußzeile pro Nachricht
  • /usage full hängt an jede Antwort eine Nutzungsfußzeile an, einschließlich geschätzter Kosten, wenn lokale Preise für das aktive Modell konfiguriert sind und Nutzungsmetadaten verfügbar sind.
  • /usage tokens zeigt nur Tokens an; OAuth-/Token- und CLI-Flows im Abo-Stil zeigen weiterhin nur Tokens an, sofern diese Runtime keine kompatiblen Nutzungsmetadaten liefert und kein ausdrücklicher lokaler Preis konfiguriert ist.
  • Hinweis zu Gemini CLI: Die standardmäßige stream-json-Ausgabe und Legacy-JSON-Overrides lesen beide die Nutzung aus stats, normalisieren stats.cached zu cacheRead und leiten Eingabe-Tokens bei Bedarf aus stats.input_tokens - stats.cached ab.
Hinweis zu Anthropic: Anthropic-Mitarbeitende haben uns mitgeteilt, dass Claude-CLI-Nutzung im OpenClaw-Stil wieder erlaubt ist. Daher behandelt OpenClaw die Wiederverwendung der Claude CLI und die Nutzung von claude -p für diese Integration als genehmigt, sofern Anthropic keine neue Richtlinie veröffentlicht. Anthropic stellt weiterhin keine Dollar-Schätzung pro Nachricht bereit, die OpenClaw in /usage full anzeigen könnte. CLI-Nutzungsfenster (Provider-Kontingente)
  • openclaw status --usage und openclaw channels list zeigen Nutzungsfenster der Provider (Kontingent-Snapshots, keine Kosten pro Nachricht).
  • Die menschenlesbare Ausgabe wird Provider-übergreifend auf X% left normalisiert.
  • Aktuelle Provider für Nutzungsfenster: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi und z.ai.
  • Hinweis zu MiniMax: Die Rohfelder usage_percent / usagePercent bedeuten verbleibendes Kontingent, daher invertiert OpenClaw sie vor der Anzeige. Zählbasierte Felder haben weiterhin Vorrang, wenn sie vorhanden sind. Wenn der Provider model_remains zurückgibt, bevorzugt OpenClaw den Chatmodell-Eintrag, leitet die Fensterbezeichnung bei Bedarf aus Zeitstempeln ab und nimmt den Modellnamen in die Tarifbezeichnung auf.
  • Die Nutzungs-Authentifizierung für diese Kontingentfenster stammt, wenn verfügbar, aus Provider-spezifischen Hooks; andernfalls fällt OpenClaw auf passende OAuth-/API-Schlüssel- Anmeldedaten aus Auth-Profilen, Env oder Konfiguration zurück.
Details und Beispiele finden Sie unter Token-Nutzung und Kosten.

​
Wie Schlüssel erkannt werden

OpenClaw kann Anmeldedaten aus folgenden Quellen übernehmen:
  • Auth-Profile (pro Agent, gespeichert in auth-profiles.json).
  • Umgebungsvariablen (z. B. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
  • Konfiguration (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
  • Skills (skills.entries.<name>.apiKey), die Schlüssel in die Prozess-Env des Skills exportieren können.

​
Funktionen, die Schlüssel verbrauchen können

​
1) Kernmodellantworten (Chat + Tools)

Jede Antwort oder jeder Tool-Aufruf nutzt den aktuellen Modell-Provider (OpenAI, Anthropic usw.). Dies ist die primäre Quelle für Nutzung und Kosten. Dies umfasst auch gehostete Provider im Abo-Stil, die weiterhin außerhalb der lokalen OpenClaw-UI abrechnen, z. B. OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan und Anthropics OpenClaw-Claude-Anmeldepfad mit aktivierter Extra Usage. Siehe Modelle für Preiskonfiguration und Token-Nutzung und Kosten für die Anzeige.

​
2) Medienverständnis (Audio/Bild/Video)

Eingehende Medien können vor dem Ausführen der Antwort zusammengefasst/transkribiert werden. Dies nutzt Modell-/Provider-APIs.
  • Audio: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
  • Bild: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
  • Video: Google / Qwen / Moonshot.
Siehe Medienverständnis.

​
3) Bild- und Videogenerierung

Gemeinsame Generierungsfunktionen können ebenfalls Provider-Schlüssel verbrauchen:
  • Bildgenerierung: OpenAI / Google / DeepInfra / fal / MiniMax
  • Videogenerierung: DeepInfra / Qwen
Die Bildgenerierung kann einen auth-gestützten Provider-Standard ableiten, wenn agents.defaults.imageGenerationModel nicht gesetzt ist. Die Videogenerierung erfordert derzeit ein ausdrückliches agents.defaults.videoGenerationModel wie qwen/wan2.6-t2v. Siehe Bildgenerierung, Qwen Cloud und Modelle.

​
4) 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
  • memorySearch.provider = "voyage" → Voyage-Embeddings
  • memorySearch.provider = "mistral" → Mistral-Embeddings
  • memorySearch.provider = "deepinfra" → DeepInfra-Embeddings
  • memorySearch.provider = "lmstudio" → LM Studio-Embeddings (lokal/selbst gehostet)
  • memorySearch.provider = "ollama" → Ollama-Embeddings (lokal/selbst gehostet; in der Regel keine Abrechnung über gehostete API)
  • Optionaler Fallback auf einen Remote-Provider, wenn lokale Embeddings fehlschlagen
Mit memorySearch.provider = "local" können Sie lokal bleiben (keine API-Nutzung). Siehe Memory.

​
5) Websuche-Tool

web_search kann je nach Ihrem Provider Nutzungskosten verursachen:
  • Brave Search API: BRAVE_API_KEY oder plugins.entries.brave.config.webSearch.apiKey
  • Exa: EXA_API_KEY oder plugins.entries.exa.config.webSearch.apiKey
  • Firecrawl: FIRECRAWL_API_KEY oder plugins.entries.firecrawl.config.webSearch.apiKey
  • Gemini (Google Search): GEMINI_API_KEY oder plugins.entries.google.config.webSearch.apiKey
  • Grok (xAI): xAI-OAuth-Profil, XAI_API_KEY oder plugins.entries.xai.config.webSearch.apiKey
  • Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY oder plugins.entries.moonshot.config.webSearch.apiKey
  • MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY oder plugins.entries.minimax.config.webSearch.apiKey
  • Ollama Web Search: schlüsselfrei für einen erreichbaren, angemeldeten lokalen Ollama-Host; direkte Suche über https://ollama.com nutzt OLLAMA_API_KEY, und auth-geschützte Hosts können normale Bearer-Auth des Ollama-Providers wiederverwenden
  • Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY oder plugins.entries.perplexity.config.webSearch.apiKey
  • Tavily: TAVILY_API_KEY oder plugins.entries.tavily.config.webSearch.apiKey
  • DuckDuckGo: schlüsselfreier Provider bei ausdrücklicher Auswahl (keine API-Abrechnung, aber inoffiziell und HTML-basiert)
  • SearXNG: SEARXNG_BASE_URL oder plugins.entries.searxng.config.webSearch.baseUrl (schlüsselfrei/selbst gehostet; keine Abrechnung über gehostete API)
Legacy-Provider-Pfade tools.web.search.* werden weiterhin über den temporären Kompatibilitäts-Shim geladen, sind aber nicht mehr die empfohlene Konfigurationsoberfläche. Kostenloses Brave Search-Guthaben: Jeder Brave-Tarif enthält $5/Monat an erneuerbarem kostenlosem Guthaben. Der Search-Tarif kostet $5 pro 1.000 Anfragen, daher deckt das Guthaben 1.000 Anfragen/Monat kostenlos ab. Setzen Sie Ihr Nutzungslimit im Brave-Dashboard, um unerwartete Kosten zu vermeiden. Siehe Webtools.

​
5) Web-Fetch-Tool (Firecrawl)

web_fetch kann Firecrawl mit schlüssellosem Starter-Zugriff aufrufen. Fügen Sie einen API-Schlüssel für höhere Limits hinzu:
  • FIRECRAWL_API_KEY oder plugins.entries.firecrawl.config.webFetch.apiKey
Wenn Firecrawl nicht konfiguriert ist, fällt das Tool auf direktes Fetch plus das gebündelte web-readability-Plugin zurück (keine kostenpflichtige API). Deaktivieren Sie plugins.entries.web-readability.enabled, um lokale Readability-Extraktion zu überspringen. Siehe Webtools.

​
6) Provider-Nutzungssnapshots (Status/Health)

Einige Statusbefehle rufen Provider-Nutzungsendpunkte auf, um Kontingentfenster oder Auth-Health anzuzeigen. Dies sind typischerweise Aufrufe mit geringem Volumen, treffen aber dennoch Provider-APIs:
  • openclaw status --usage
  • openclaw models status --json
Siehe Modelle-CLI.

​
7) Schutz-Zusammenfassung bei Compaction

Der Compaction-Schutz kann den Sitzungsverlauf mit dem aktuellen Modell zusammenfassen, was Provider-APIs aufruft, wenn er ausgeführt wird. Siehe Sitzungsverwaltung + Compaction.

​
8) Modellscan / Probe

openclaw models scan kann OpenRouter-Modelle prüfen und nutzt OPENROUTER_API_KEY, wenn das Prüfen aktiviert ist. Siehe Modelle-CLI.

​
9) Talk (Sprache)

Der Talk-Modus kann ElevenLabs aufrufen, wenn konfiguriert:
  • ELEVENLABS_API_KEY oder talk.providers.elevenlabs.apiKey
Siehe Talk-Modus.

​
10) Skills (Drittanbieter-APIs)

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

​
Verwandte Themen