> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 de laatste reactie.
* Als OpenClaw gebruiksmetadata en lokale prijzen voor het actieve model heeft,
  toont `/status` ook **geschatte kosten** voor het laatste antwoord. Dit kan
  expliciet geprijsde providers zonder API-sleutel omvatten, zoals Bedrock `aws-sdk`-modellen.
* Als live sessiemetadata beperkt is, kan `/status` token-/cachetellers
  en het actieve runtime-modellabel herstellen uit de nieuwste transcriptgebruiksvermelding.
  Bestaande live waarden die niet nul zijn, krijgen nog steeds voorrang, en transcripttotalen
  ter grootte van prompts kunnen winnen wanneer opgeslagen totalen ontbreken of kleiner zijn.

**Kostenvoet per bericht**

* `/usage full` voegt een gebruiksvoet toe aan elk antwoord, inclusief **geschatte kosten**
  wanneer lokale prijzen zijn geconfigureerd voor het actieve model en gebruiksmetadata
  beschikbaar is.
* `/usage tokens` toont alleen tokens; OAuth-/token- en CLI-flows in abonnementsstijl
  tonen nog steeds alleen tokens, tenzij die runtime compatibele gebruiksmetadata levert
  en een expliciete lokale prijs is geconfigureerd.
* Gemini CLI-opmerking: de standaard `stream-json`-uitvoer en legacy JSON-overschrijvingen
  lezen beide gebruik uit `stats`, normaliseren `stats.cached` naar `cacheRead`, en
  leiden invoertokens af uit `stats.input_tokens - stats.cached` wanneer dat nodig is.

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

**CLI-gebruiksvensters (providerquota)**

* `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 telling gebaseerde velden winnen nog steeds
  wanneer ze aanwezig zijn. Als de provider `model_remains` retourneert, geeft OpenClaw de voorkeur aan de
  vermelding voor het chatmodel, leidt het vensterlabel af uit tijdstempels wanneer nodig, 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-sleutelreferenties
  uit auth-profielen, env of config.

Zie [Tokengebruik en kosten](/nl/reference/token-use) voor details en voorbeelden.

## Hoe sleutels worden ontdekt

OpenClaw kan referenties oppikken 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) Kernmodelreacties (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
de lokale UI van OpenClaw factureren, zoals **OpenAI Codex**, **Alibaba Cloud Model Studio
Coding Plan**, **MiniMax Coding Plan**, **Z.AI / GLM Coding Plan**, en
Anthropic's Claude-loginpad van OpenClaw met **Extra Usage** ingeschakeld.

Zie [Modellen](/nl/providers/models) voor prijsconfiguratie en [Tokengebruik en kosten](/nl/reference/token-use) 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](/nl/nodes/media-understanding).

### 3) Afbeeldings- en videogeneratie

Gedeelde generatiemogelijkheden kunnen ook providersleutels verbruiken:

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

Afbeeldingsgeneratie kan een standaardprovider op basis van auth afleiden wanneer
`agents.defaults.imageGenerationModel` niet is ingesteld. Videogeneratie vereist momenteel
een expliciete `agents.defaults.videoGenerationModel`, zoals
`qwen/wan2.6-t2v`.

Zie [Afbeeldingsgeneratie](/nl/tools/image-generation), [Qwen Cloud](/nl/providers/qwen),
en [Modellen](/nl/concepts/models).

### 4) Geheugenembeddings + semantisch zoeken

Semantisch zoeken in geheugen gebruikt **embedding-API's** wanneer dit 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 gehoste API-facturering)
* Optionele fallback naar een externe provider als lokale embeddings mislukken

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

Zie [Geheugen](/nl/concepts/memory).

### 5) Tool voor webzoeken

`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 OAuth-profiel, `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; directe `https://ollama.com`-zoekopdrachten gebruiken `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**: provider zonder sleutel wanneer expliciet geselecteerd (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 gehoste API-facturering)

Legacy providerpaden `tools.web.search.*` worden nog steeds geladen via de tijdelijke compatibiliteitsshim, maar ze zijn niet langer het aanbevolen configoppervlak.

**Gratis Brave Search-tegoed:** Elk Brave-plan bevat \$5/maand aan vernieuwend
gratis tegoed. Het Search-plan 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](/nl/tools/web).

### 5) Tool voor web ophalen (Firecrawl)

`web_fetch` kan **Firecrawl** aanroepen met starterslimieten zonder sleutel. Voeg een API-sleutel toe
voor hogere limieten:

* `FIRECRAWL_API_KEY` of `plugins.entries.firecrawl.config.webFetch.apiKey`

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

Zie [Webtools](/nl/tools/web).

### 6) Providergebruikssnapshots (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](/nl/cli/models).

### 7) Compaction-beveiligingssamenvatting

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

Zie [Sessiebeheer + Compaction](/nl/reference/session-management-compaction).

### 8) Modelscan / probe

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

Zie [Modellen-CLI](/nl/cli/models).

### 9) Talk (spraak)

Talk-modus kan **ElevenLabs** aanroepen wanneer geconfigureerd:

* `ELEVENLABS_API_KEY` of `talk.providers.elevenlabs.apiKey`

Zie [Talk-modus](/nl/nodes/talk).

### 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](/nl/tools/skills).

## Gerelateerd

* [Tokengebruik en kosten](/nl/reference/token-use)
* [Promptcaching](/nl/reference/prompt-caching)
* [Gebruikstracking](/nl/concepts/usage-tracking)