Technical reference

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 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 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 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, Qwen Cloud, en Modellen.

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.

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.

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.

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.

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.

8) Modelscan / probe

openclaw models scan kan OpenRouter-modellen peilen en gebruikt OPENROUTER_API_KEY wanneer peilen 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

Was this useful?