API-gebruik en kosten

Dit document vermeldt functies die API-sleutels kunnen aanroepen en waar hun kosten zichtbaar worden. Het richt zich op OpenClaw-functies die providergebruik of betaalde API-aanroepen kunnen genereren.

# Waar kosten zichtbaar worden (chat + CLI)

Kostensnapshot per sessie

• /status toont het huidige sessiemodel, contextgebruik en tokens van het laatste antwoord.
• Als het model API-sleutel-authenticatie gebruikt, toont /status ook de geschatte kosten voor het laatste antwoord.
• Als live sessiemetadata beperkt is, kan /status token-/cachetellers en het actieve runtime-modelabel herstellen uit de nieuwste transcript-gebruiksvermelding. Bestaande niet-nul live waarden krijgen nog steeds voorrang, en transcript-totalen op promptgrootte kunnen winnen wanneer opgeslagen totalen ontbreken of kleiner zijn.

Kostenvoet per bericht

• /usage full voegt een gebruiksvoet toe aan elk antwoord, inclusief geschatte kosten (alleen API-sleutel).
• /usage tokens toont alleen tokens; OAuth-/token- en CLI-flows in abonnementsstijl verbergen dollarkosten.
• Gemini CLI-opmerking: wanneer de CLI JSON-uitvoer teruggeeft, leest OpenClaw gebruik uit stats, normaliseert stats.cached naar cacheRead, en leidt invoertokens af uit stats.input_tokens - stats.cached wanneer dat nodig is.

Anthropic-opmerking: Anthropic-medewerkers hebben ons verteld dat OpenClaw-achtig Claude CLI-gebruik weer is toegestaan, dus OpenClaw behandelt hergebruik van Claude CLI en gebruik van claude -p als goedgekeurd voor deze integratie, tenzij Anthropic een nieuw beleid publiceert. Anthropic stelt nog steeds geen dollarschatting per bericht beschikbaar die OpenClaw kan tonen in /usage full.

CLI-gebruiksvensters (providerquota's)

• openclaw status --usage en openclaw channels list tonen gebruiksvensters van providers (quotasnapshots, geen kosten per bericht).
• Menselijke uitvoer wordt genormaliseerd naar X% left voor alle providers.
• Huidige providers voor gebruiksvensters: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi en z.ai.
• MiniMax-opmerking: de ruwe velden usage_percent / usagePercent betekenen resterend quota, dus OpenClaw keert ze om vóór weergave. Op aantallen gebaseerde velden winnen nog steeds wanneer ze aanwezig zijn. Als de provider model_remains teruggeeft, geeft OpenClaw de voorkeur aan de chatmodelvermelding, leidt het vensterlabel indien nodig af uit tijdstempels, en neemt de modelnaam op in het planlabel.
• Gebruiksauthenticatie voor die quotavensters komt uit providerspecifieke hooks wanneer beschikbaar; anders valt OpenClaw terug op overeenkomende OAuth-/API-sleutel- referenties uit auth-profielen, env of config.

Zie Tokengebruik en kosten voor details en voorbeelden.

# Hoe sleutels worden ontdekt

OpenClaw kan referenties ophalen uit:

• Auth-profielen (per agent, opgeslagen in auth-profiles.json).
• Omgevingsvariabelen (bijv. OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY).
• Config (models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, memorySearch.*, talk.providers.*.apiKey).
• Skills (skills.entries.<name>.apiKey) die sleutels kunnen exporteren naar de env van het skillproces.

# Functies die sleutels kunnen verbruiken

# 1) Kernmodelantwoorden (chat + tools)

Elk antwoord of elke toolaanroep gebruikt de huidige modelprovider (OpenAI, Anthropic, enz.). Dit is de primaire bron van gebruik en kosten.

Dit omvat ook gehoste providers in abonnementsstijl die nog steeds buiten OpenClaw's lokale UI factureren, zoals OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan, en Anthropic's OpenClaw Claude-loginpad met Extra Usage ingeschakeld.

Zie Modellen voor prijsconfiguratie en Tokengebruik en kosten voor weergave.

# 2) Mediabegrip (audio/afbeelding/video)

Binnenkomende media kunnen worden samengevat/getranscribeerd voordat het antwoord wordt uitgevoerd. Dit gebruikt model-/provider-API's.

• Audio: OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
• Afbeelding: OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
• Video: Google / Qwen / Moonshot.

Zie Mediabegrip.

# 3) Afbeeldings- en videogeneratie

Gedeelde generatiemogelijkheden kunnen ook providersleutels verbruiken:

• Afbeeldingsgeneratie: OpenAI / Google / DeepInfra / fal / MiniMax
• Videogeneratie: DeepInfra / Qwen

Afbeeldingsgeneratie kan een door auth ondersteunde providerstandaard afleiden wanneer agents.defaults.imageGenerationModel niet is ingesteld. Videogeneratie vereist momenteel een expliciete agents.defaults.videoGenerationModel, zoals qwen/wan2.6-t2v.

Zie Afbeeldingsgeneratie, Qwen Cloud, en Modellen.

# 4) Geheugenembeddings + semantisch zoeken

Semantisch zoeken in geheugen gebruikt embedding-API's wanneer het is geconfigureerd voor externe providers:

• 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 (lokaal/zelf gehost)
• memorySearch.provider = "ollama" → Ollama-embeddings (lokaal/zelf gehost; doorgaans geen gefactureerde gehoste API)
• Optionele fallback naar een externe provider als lokale embeddings mislukken

Je kunt het lokaal houden met memorySearch.provider = "local" (geen API-gebruik).

Zie Geheugen.

# 5) Webzoektool

web_search kan gebruikskosten veroorzaken, afhankelijk van je provider:

• Brave Search API: BRAVE_API_KEY of plugins.entries.brave.config.webSearch.apiKey
• Exa: EXA_API_KEY of plugins.entries.exa.config.webSearch.apiKey
• Firecrawl: FIRECRAWL_API_KEY of plugins.entries.firecrawl.config.webSearch.apiKey
• Gemini (Google Search): GEMINI_API_KEY of plugins.entries.google.config.webSearch.apiKey
• Grok (xAI): XAI_API_KEY of plugins.entries.xai.config.webSearch.apiKey
• Kimi (Moonshot): KIMI_API_KEY, MOONSHOT_API_KEY, of plugins.entries.moonshot.config.webSearch.apiKey
• MiniMax Search: MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY, of plugins.entries.minimax.config.webSearch.apiKey
• Ollama Web Search: zonder sleutel voor een bereikbare aangemelde lokale Ollama-host; direct zoeken via https://ollama.com gebruikt OLLAMA_API_KEY, en met auth beschermde hosts kunnen normale Ollama-provider bearer-auth hergebruiken
• Perplexity Search API: PERPLEXITY_API_KEY, OPENROUTER_API_KEY, of plugins.entries.perplexity.config.webSearch.apiKey
• Tavily: TAVILY_API_KEY of plugins.entries.tavily.config.webSearch.apiKey
• DuckDuckGo: fallback zonder sleutel (geen API-facturering, maar onofficieel en gebaseerd op HTML)
• SearXNG: SEARXNG_BASE_URL of plugins.entries.searxng.config.webSearch.baseUrl (zonder sleutel/zelf gehost; geen gefactureerde gehoste API)

Legacy tools.web.search.*-providerpaden laden nog steeds via de tijdelijke compatibiliteitsshim, maar ze zijn niet langer het aanbevolen config-oppervlak.

Gratis Brave Search-tegoed: Elk Brave-abonnement bevat $5/maand aan vernieuwend gratis tegoed. Het Search-abonnement kost $5 per 1.000 verzoeken, dus het tegoed dekt 1.000 verzoeken/maand zonder kosten. Stel je gebruikslimiet in het Brave-dashboard in om onverwachte kosten te voorkomen.

Zie Webtools.

# 5) Webophaalttool (Firecrawl)

web_fetch kan Firecrawl aanroepen wanneer er een API-sleutel aanwezig is:

• FIRECRAWL_API_KEY of plugins.entries.firecrawl.config.webFetch.apiKey

Als Firecrawl niet is geconfigureerd, valt de tool terug op direct ophalen plus de meegeleverde web-readability-plugin (geen betaalde API). Schakel plugins.entries.web-readability.enabled uit om lokale Readability-extractie over te slaan.

Zie Webtools.

# 6) Providergebruiksnapshots (status/gezondheid)

Sommige statuscommando's roepen providergebruikseindpunten aan om quotavensters of auth-gezondheid weer te geven. Dit zijn doorgaans aanroepen met laag volume, maar ze raken nog steeds provider-API's:

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

Zie Modellen-CLI.

# 7) Samenvatting als Compaction-beveiliging

De Compaction-beveiliging kan sessiegeschiedenis samenvatten met het huidige model, wat provider-API's aanroept wanneer deze wordt uitgevoerd.

Zie Sessiebeheer + Compaction.

# 8) Modelscan / probe

openclaw models scan kan OpenRouter-modellen proben en gebruikt OPENROUTER_API_KEY wanneer proben is ingeschakeld.

Zie Modellen-CLI.

# 9) Talk (spraak)

Talk-modus kan ElevenLabs aanroepen wanneer geconfigureerd:

• ELEVENLABS_API_KEY of talk.providers.elevenlabs.apiKey

Zie Talk-modus.

# 10) Skills (API's van derden)

Skills kunnen apiKey opslaan in skills.entries.<name>.apiKey. Als een skill die sleutel gebruikt voor externe API's, kan dit kosten veroorzaken volgens de provider van de skill.

Zie Skills.

# Gerelateerd

• Tokengebruik en kosten
• Promptcaching
• Gebruikstracking