Technical reference

Utilisation de l’API et coûts

Ce document répertorie les fonctionnalités qui peuvent invoquer des clés API et où leurs coûts apparaissent. Il se concentre sur les fonctionnalités d’OpenClaw qui peuvent générer de l’utilisation fournisseur ou des appels API payants.

Où les coûts apparaissent (chat + CLI)

Instantané du coût par session

/status affiche le modèle de la session actuelle, l’utilisation du contexte et les tokens de la dernière réponse.
Si OpenClaw dispose de métadonnées d’utilisation et d’une tarification locale pour le modèle actif, /status affiche aussi le coût estimé de la dernière réponse. Cela peut inclure des fournisseurs sans clé API à tarification explicite, comme les modèles Bedrock aws-sdk.
Si les métadonnées de session en direct sont limitées, /status peut récupérer les compteurs de tokens/cache et le libellé du modèle d’exécution actif depuis la dernière entrée d’utilisation de la transcription. Les valeurs en direct non nulles existantes restent prioritaires, et les totaux de transcription de taille prompt peuvent l’emporter lorsque les totaux stockés sont absents ou plus petits.

Pied de page de coût par message

/usage full ajoute un pied de page d’utilisation à chaque réponse, y compris le coût estimé lorsque la tarification locale est configurée pour le modèle actif et que les métadonnées d’utilisation sont disponibles.
/usage tokens affiche uniquement les tokens ; les flux OAuth/token de type abonnement et les flux CLI continuent d’afficher uniquement les tokens, sauf si ce runtime fournit des métadonnées d’utilisation compatibles et qu’un prix local explicite est configuré.
Note Gemini CLI : la sortie par défaut stream-json et les remplacements JSON hérités lisent tous deux l’utilisation depuis stats, normalisent stats.cached en cacheRead et dérivent les tokens d’entrée depuis stats.input_tokens - stats.cached si nécessaire.

Note Anthropic : le personnel d’Anthropic nous a indiqué que l’utilisation de Claude CLI de type OpenClaw est à nouveau autorisée ; OpenClaw considère donc la réutilisation de Claude CLI et l’utilisation de claude -p comme approuvées pour cette intégration, sauf si Anthropic publie une nouvelle politique. Anthropic n’expose toujours pas d’estimation en dollars par message qu’OpenClaw pourrait afficher dans /usage full.

Fenêtres d’utilisation CLI (quotas fournisseur)

openclaw status --usage et openclaw channels list affichent les fenêtres d’utilisation fournisseur (instantanés de quota, pas des coûts par message).
La sortie humaine est normalisée en X% left pour tous les fournisseurs.
Fournisseurs actuels de fenêtres d’utilisation : Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi et z.ai.
Note MiniMax : ses champs bruts usage_percent / usagePercent signifient quota restant ; OpenClaw les inverse donc avant l’affichage. Les champs basés sur des nombres restent prioritaires lorsqu’ils sont présents. Si le fournisseur renvoie model_remains, OpenClaw privilégie l’entrée du modèle de chat, déduit le libellé de la fenêtre à partir des horodatages si nécessaire, et inclut le nom du modèle dans le libellé du plan.
L’authentification d’utilisation pour ces fenêtres de quota provient de hooks propres au fournisseur lorsqu’ils sont disponibles ; sinon, OpenClaw se rabat sur des identifiants OAuth/API-key correspondants issus des profils d’authentification, de l’env ou de la config.

Consultez Utilisation des tokens et coûts pour plus de détails et d’exemples.

Comment les clés sont découvertes

OpenClaw peut récupérer les identifiants depuis :

Profils d’authentification (par agent, stockés dans auth-profiles.json).
Variables d’environnement (par ex. 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) qui peuvent exporter des clés vers l’env du processus de skill.

Fonctionnalités qui peuvent dépenser des clés

1) Réponses du modèle principal (chat + outils)

Chaque réponse ou appel d’outil utilise le fournisseur de modèle actuel (OpenAI, Anthropic, etc.). C’est la principale source d’utilisation et de coût.

Cela inclut aussi les fournisseurs hébergés de type abonnement qui facturent toujours en dehors de l’interface locale d’OpenClaw, comme OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI / GLM Coding Plan, et le parcours de connexion Claude d’OpenClaw via Anthropic avec Extra Usage activé.

Consultez Modèles pour la config de tarification et Utilisation des tokens et coûts pour l’affichage.

2) Compréhension des médias (audio/image/vidéo)

Les médias entrants peuvent être résumés/transcrits avant l’exécution de la réponse. Cela utilise les API de modèles/fournisseurs.

Audio : OpenAI / Groq / Deepgram / DeepInfra / Google / Mistral.
Image : OpenAI / OpenRouter / Anthropic / DeepInfra / Google / MiniMax / Moonshot / Qwen / Z.AI.
Vidéo : Google / Qwen / Moonshot.

Consultez Compréhension des médias.

3) Génération d’images et de vidéos

Les capacités de génération partagées peuvent aussi dépenser des clés fournisseur :

Génération d’images : OpenAI / Google / DeepInfra / fal / MiniMax
Génération de vidéos : DeepInfra / Qwen

La génération d’images peut déduire un fournisseur par défaut adossé à l’authentification lorsque agents.defaults.imageGenerationModel n’est pas défini. La génération de vidéos exige actuellement un agents.defaults.videoGenerationModel explicite, tel que qwen/wan2.6-t2v.

Consultez Génération d’images, Qwen Cloud et Modèles.

4) Embeddings mémoire + recherche sémantique

La recherche sémantique en mémoire utilise des API d’embeddings lorsqu’elle est configurée pour des fournisseurs distants :

memorySearch.provider = "openai" → embeddings OpenAI
memorySearch.provider = "gemini" → embeddings Gemini
memorySearch.provider = "voyage" → embeddings Voyage
memorySearch.provider = "mistral" → embeddings Mistral
memorySearch.provider = "deepinfra" → embeddings DeepInfra
memorySearch.provider = "lmstudio" → embeddings LM Studio (local/auto-hébergé)
memorySearch.provider = "ollama" → embeddings Ollama (local/auto-hébergé ; généralement sans facturation API hébergée)
Repli facultatif vers un fournisseur distant si les embeddings locaux échouent

Vous pouvez la garder locale avec memorySearch.provider = "local" (aucune utilisation d’API).

Consultez Mémoire.

5) Outil de recherche web

web_search peut entraîner des frais d’utilisation selon votre fournisseur :

Brave Search API : BRAVE_API_KEY ou plugins.entries.brave.config.webSearch.apiKey
Exa : EXA_API_KEY ou plugins.entries.exa.config.webSearch.apiKey
Firecrawl : FIRECRAWL_API_KEY ou plugins.entries.firecrawl.config.webSearch.apiKey
Gemini (Google Search) : GEMINI_API_KEY ou plugins.entries.google.config.webSearch.apiKey
Grok (xAI) : profil OAuth xAI, XAI_API_KEY, ou plugins.entries.xai.config.webSearch.apiKey
Kimi (Moonshot) : KIMI_API_KEY, MOONSHOT_API_KEY, ou plugins.entries.moonshot.config.webSearch.apiKey
MiniMax Search : MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_API_KEY, ou plugins.entries.minimax.config.webSearch.apiKey
Ollama Web Search : sans clé pour un hôte Ollama local connecté et accessible ; la recherche directe https://ollama.com utilise OLLAMA_API_KEY, et les hôtes protégés par authentification peuvent réutiliser l’authentification bearer normale du fournisseur Ollama
Perplexity Search API : PERPLEXITY_API_KEY, OPENROUTER_API_KEY, ou plugins.entries.perplexity.config.webSearch.apiKey
Tavily : TAVILY_API_KEY ou plugins.entries.tavily.config.webSearch.apiKey
DuckDuckGo : fournisseur sans clé lorsqu’il est explicitement sélectionné (pas de facturation API, mais non officiel et basé sur HTML)
SearXNG : SEARXNG_BASE_URL ou plugins.entries.searxng.config.webSearch.baseUrl (sans clé/auto-hébergé ; pas de facturation API hébergée)

Les chemins fournisseur hérités tools.web.search.* se chargent toujours via le shim de compatibilité temporaire, mais ils ne constituent plus la surface de config recommandée.

Crédit gratuit Brave Search : Chaque plan Brave inclut 5 $ par mois de crédit gratuit renouvelé. Le plan Search coûte 5 $ pour 1 000 requêtes, donc le crédit couvre 1 000 requêtes par mois sans frais. Définissez votre limite d’utilisation dans le tableau de bord Brave pour éviter les frais inattendus.

Consultez Outils web.

5) Outil de récupération web (Firecrawl)

web_fetch peut appeler Firecrawl avec un accès de démarrage sans clé. Ajoutez une clé API pour des limites plus élevées :

FIRECRAWL_API_KEY ou plugins.entries.firecrawl.config.webFetch.apiKey

Si Firecrawl n’est pas configuré, l’outil se rabat sur une récupération directe plus le plugin web-readability inclus (pas d’API payante). Désactivez plugins.entries.web-readability.enabled pour ignorer l’extraction Readability locale.

Consultez Outils web.

6) Instantanés d’utilisation fournisseur (statut/santé)

Certaines commandes de statut appellent des points de terminaison d’utilisation fournisseur pour afficher des fenêtres de quota ou l’état d’authentification. Ce sont généralement des appels à faible volume, mais ils touchent tout de même les API fournisseur :

openclaw status --usage
openclaw models status --json

Consultez CLI des modèles.

7) Résumé de protection Compaction

La protection Compaction peut résumer l’historique de session avec le modèle actuel, ce qui invoque les API fournisseur lorsqu’elle s’exécute.

Consultez Gestion de session + Compaction.

8) Analyse / sonde de modèles

openclaw models scan peut sonder des modèles OpenRouter et utilise OPENROUTER_API_KEY lorsque la sonde est activée.

Consultez CLI des modèles.

9) Talk (parole)

Le mode Talk peut invoquer ElevenLabs lorsqu’il est configuré :

ELEVENLABS_API_KEY ou talk.providers.elevenlabs.apiKey

Consultez Mode Talk.

10) Skills (API tierces)

Les Skills peuvent stocker apiKey dans skills.entries.<name>.apiKey. Si un skill utilise cette clé pour des API externes, il peut entraîner des coûts selon le fournisseur du skill.

Consultez Skills.

Connexe

Was this useful?