API-Nutzung und Kosten unter Kontrolle

Wer kennt es nicht? Du setzt ein neues Tool auf, probierst ein paar Features aus und am Ende des Monats folgt der Schock beim Blick auf die Abrechnung des API-Providers. Es ist oft schwierig nachzuvollziehen, welche Aktion welche Kosten verursacht hat oder wo genau die Keys eigentlich hinterlegt sind.

Damit du keine bösen Überraschungen erlebst, zeigt dir dieser Guide, wie OpenClaw mit API-Keys umgeht und wo du deinen Verbrauch im Blick behältst.

Voraussetzungen

• Eine laufende OpenClaw Installation
• Gültige API-Keys (z. B. OpenAI, Anthropic oder Google)
• Zugriff auf deine auth-profiles.json
• Grundkenntnisse im Umgang mit der CLI

Schnellstart

In weniger als fünf Minuten hast du die volle Kontrolle über deine Ausgaben:

1. Status im Chat prüfen: Gib /status in deiner Session ein. Du siehst sofort das aktuelle Modell, den Context-Verbrauch und die geschätzten Kosten der letzten Antwort.
2. Usage-Footer aktivieren: Nutze den Befehl /usage full. OpenClaw hängt nun an jede Antwort einen Footer mit den geschätzten Kosten an (nur bei API-Key-Authentifizierung).
3. Provider-Quotas abrufen: Nutze die CLI mit openclaw status --usage, um Schnappschüsse deiner Quotas direkt vom Provider zu erhalten.
4. Auth-Profile kontrollieren: Prüfe die Datei auth-profiles.json, um zu sehen, welche Keys für welche Agenten hinterlegt sind.

Wo API-Keys Kosten verursachen

OpenClaw nutzt Keys an verschiedenen Stellen. Hier sind die wichtigsten Funktionen, die dein Guthaben verbrauchen:

1. Core-Modelle und Media Understanding

Jede Antwort und jeder Tool-Aufruf nutzt das eingestellte Modell (OpenAI, Anthropic etc.). Das ist der Hauptfaktor für deine Kosten. Wenn du Bilder, Audio oder Videos hochlädst, werden diese vor der Antwort verarbeitet:

• Audio: Wird automatisch über OpenAI, Groq oder Deepgram transkribiert, sobald Keys vorhanden sind.
• Bilder/Video: Die Analyse erfolgt über Provider wie Google oder Anthropic.

2. Memory und Suche

Wenn du die semantische Suche für dein Gedächtnis nutzt, fallen Kosten für Embeddings an.

• Remote: Provider wie openai, gemini oder voyage verursachen Kosten.
• Lokal: Mit memorySearch.provider = "local" entstehen keine API-Kosten.

3. Web-Tools (Search & Fetch)

Das Tool web_search nutzt Keys für Brave oder Perplexity. Brave bietet einen kostenlosen Tier mit 2.000 Anfragen pro Monat an, erfordert aber eine Kreditkarte zur Verifizierung. Das Tool web_fetch nutzt Firecrawl, falls ein Key hinterlegt ist; ansonsten erfolgt ein direkter Fetch ohne API-Kosten.

4. System-Aktionen

Auch Hintergrundprozesse können Keys nutzen:

• Compaction: Wenn die Session-Historie zusammengefasst wird, nutzt OpenClaw das aktuelle Modell.
• Model Scan: Der Befehl openclaw models scan prüft OpenRouter-Modelle, was den entsprechenden Key nutzt.
• Talk Mode: Hier entstehen Kosten bei ElevenLabs für die Sprachausgabe.

Wo OpenClaw nach Keys sucht

OpenClaw findet deine Credentials an vier verschiedenen Orten:

1. Auth-Profile: Gespeichert in der auth-profiles.json.
2. Umgebungsvariablen: Zum Beispiel OPENAI_API_KEY oder BRAVE_API_KEY.
3. Config: In den Sektionen models.providers, tools.web oder memorySearch.
4. Skills: Keys können direkt in skills.entries.<name>.apiKey hinterlegt sein.

Fehlerbehebung

• Kosten werden nicht angezeigt: Falls du OAuth-Flows nutzt, werden keine Dollar-Beträge angezeigt. Nutze /usage tokens, um zumindest den Token-Verbrauch zu sehen.
• Unerwartete Kosten durch Audio: Audio-Transkription ist automatisch aktiviert, sobald ein passender Key gefunden wird. Entferne den Key aus der Config oder den Umgebungsvariablen, um dies zu verhindern.
• Fehlgeschlagene Embeddings: Wenn lokale Embeddings fehlschlagen, versucht OpenClaw optional einen Remote-Provider. Prüfe deine memorySearch.provider Einstellungen.
• Quota-Limits: Wenn Befehle fehlschlagen, nutze openclaw channels list, um den Status deiner Provider-Verbindung zu prüfen.

Du hast Fragen zu einem spezifischen Setup? Nutze den AI Setup Assistant für direkte Hilfe.

Nächste Schritte

• Token use & costs
• Models CLI
• Memory Concepts
• Web Tools Setup