Utilisation et coûts de l’API

Carte des fonctionnalités d’OpenClaw susceptibles d’appeler des API de fournisseurs payantes, indiquant où chacune lit ses identifiants et où apparaît le coût qui en résulte.

Où apparaissent les coûts

/status (instantané par session)

• Affiche le modèle de la session actuelle, l’utilisation du contexte et les tokens de la dernière réponse.
• Ajoute un coût estimé pour la dernière réponse lorsqu’OpenClaw dispose des métadonnées d’utilisation et de la tarification locale du modèle actif, y compris pour les fournisseurs sans clé d’API dont le prix est explicitement défini, tels que les modèles Bedrock aws-sdk.
• Si l’instantané de la session en cours est incomplet, /status récupère les compteurs de tokens et de cache ainsi que le libellé du modèle actif à partir de la dernière entrée d’utilisation de la transcription. Les valeurs actives non nulles existantes prévalent sur les données de transcription ; un total de transcription correspondant à la taille de l’invite peut néanmoins prévaloir lorsque le total stocké est absent ou inférieur.

/usage (pied de page par message)

• /usage full ajoute un pied de page d’utilisation à chaque réponse, avec le coût estimé lorsque la tarification locale est configurée et que les métadonnées d’utilisation sont disponibles.
• /usage tokens affiche uniquement les tokens. Les exécutions CLI et celles utilisant un abonnement avec OAuth ou un token affichent uniquement les tokens, sauf si elles fournissent des métadonnées d’utilisation compatibles ainsi qu’un prix local explicite.
• /usage cost affiche un récapitulatif local des coûts ; /usage off désactive le pied de page.
• Remarque concernant Gemini CLI : les sorties stream-json et l’ancien format json incluent toutes deux l’utilisation dans stats. OpenClaw normalise stats.cached en cacheRead et, si nécessaire, calcule les tokens d’entrée avec stats.input_tokens - stats.cached.

Interface de contrôle → Utilisation (analyse intersessions)

• Affiche les totaux de tokens et de coûts estimés dérivés des transcriptions pour la plage de dates sélectionnée, avec une ventilation par fournisseur, modèle, agent, canal et type de token.
• Compare des fenêtres calendaires plus courtes se terminant à la date de fin de la plage sélectionnée. Les dates manquantes sont comptabilisées comme des jours calendaires sans utilisation ; elles ne sont pas ignorées pour créer une fenêtre plus dense.
• Indique directement l’échelle du graphique quotidien. Un badge √ signifie qu’une compression par racine carrée permet de conserver la visibilité des jours à faible utilisation.
• Ces totaux décrivent l’historique local des sessions disponible, et non une facture de fournisseur ni un registre de facturation cumulé. L’interface avertit lorsque la tarification manque pour certaines entrées.

Fenêtres d’utilisation de la CLI (quotas des fournisseurs, et non coût par message)

• openclaw status --usage et openclaw channels list affichent les fenêtres d’utilisation des fournisseurs sous la forme X% left.
• Fournisseurs actuels prenant en charge les fenêtres d’utilisation : Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (couvre l’authentification OAuth/par token de ChatGPT/Codex), Xiaomi et z.ai. Consultez CLI des modèles et CLI des canaux pour obtenir la liste complète des fournisseurs et des indicateurs.
• Les champs bruts usage_percent / usagePercent de MiniMax indiquent le quota restant ; OpenClaw les inverse donc. Les champs fondés sur un décompte prévalent lorsqu’ils sont présents. Si la réponse contient un tableau model_remains, OpenClaw sélectionne l’entrée du modèle de discussion, déduit au besoin le libellé de la fenêtre à partir des horodatages et inclut le nom du modèle dans le libellé de l’offre.
• L’authentification utilisée pour consulter l’utilisation provient des hooks propres au fournisseur lorsqu’ils sont disponibles. Dans le cas contraire, OpenClaw utilise les identifiants OAuth ou de clé d’API correspondants provenant des profils d’authentification, de l’environnement ou de la configuration.

Consultez Utilisation des tokens et coûts pour des exemples détaillés.

Méthodes de détection des clés

• Profils d’authentification : propres à chaque agent, stockés dans auth-profiles.json.
• Variables d’environnement : par exemple OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY.
• Configuration : models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, agents.defaults.memorySearch.*, talk.providers.*.apiKey.
• Skills : skills.entries.<name>.apiKey, qui peut exporter la clé vers l’environnement du processus de la Skill.

Fonctionnalités susceptibles d’utiliser des clés payantes

Réponses du modèle principal (discussion et outils)

Chaque réponse ou appel d’outil s’exécute sur le fournisseur du modèle actuel. Il s’agit de la principale source d’utilisation et de coûts, y compris pour les offres hébergées par abonnement dont la facturation s’effectue en dehors de l’interface locale d’OpenClaw : OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan et le mode de connexion à Claude d’Anthropic lorsque l’option Extra Usage est activée.

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

Compréhension des médias (audio, image et vidéo)

Les médias entrants peuvent être résumés ou transcrits par l’API d’un fournisseur avant l’exécution du pipeline de réponse. La prise en charge des fournisseurs est enregistrée par Plugin et évolue à mesure que des Plugins sont ajoutés ; consultez Compréhension des médias pour connaître la liste et la configuration actuelles.

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

image_generate et video_generate acheminent la requête vers tout fournisseur configuré disponible. La génération d’images peut déduire un fournisseur par défaut disposant d’une authentification lorsque agents.defaults.imageGenerationModel n’est pas défini ; la génération de vidéos exige une valeur explicite pour agents.defaults.videoGenerationModel (par exemple qwen/wan2.6-t2v).

Consultez Génération d’images et Génération de vidéos pour connaître la liste actuelle des fournisseurs.

Plongements de mémoire et recherche sémantique

La recherche sémantique dans la mémoire utilise des API de plongement lorsque agents.defaults.memorySearch.provider désigne un adaptateur distant (par exemple openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock). memorySearch.provider = "lmstudio" ou "ollama" s’exécute sur un serveur local ou auto-hébergé et n’entraîne généralement aucune facturation d’hébergement. memorySearch.provider = "local" conserve toutes les opérations sur l’appareil, sans utiliser d’API. Un fournisseur memorySearch.fallback facultatif peut prendre le relais en cas d’échec des plongements locaux.

Consultez Mémoire.

Outil de recherche Web

web_search peut entraîner des frais d’utilisation selon le fournisseur sélectionné. Chaque fournisseur lit d’abord sa clé depuis une variable d’environnement, puis depuis plugins.entries.<id>.config.webSearch.apiKey :

Les anciens chemins de configuration tools.web.search.* sont toujours chargés par l’intermédiaire d’une couche de compatibilité, mais ne constituent plus l’interface recommandée.

Crédit gratuit Brave Search : chaque offre comprend un crédit gratuit renouvelable de 5 $ par mois. L’offre Search coûte 5 $ pour 1 000 requêtes ; le crédit couvre donc gratuitement 1 000 requêtes par mois. Définissez une limite d’utilisation dans le tableau de bord Brave afin d’éviter les frais imprévus.

Consultez Outils Web.

Outil de récupération Web (Firecrawl)

web_fetch peut appeler Firecrawl avec un accès de démarrage sans clé ; ajoutez FIRECRAWL_API_KEY (ou plugins.entries.firecrawl.config.webFetch.apiKey) pour bénéficier de limites plus élevées. Si Firecrawl n’est pas configuré, l’outil utilise en repli une récupération directe ainsi que le Plugin web-readability intégré, sans API payante. Désactivez plugins.entries.web-readability.enabled pour ignorer l’extraction Readability locale.

Consultez Outils Web.

Instantanés d’utilisation des fournisseurs (état/santé)

openclaw status --usage et openclaw models status --json appellent les points de terminaison d’utilisation des fournisseurs afin d’afficher les fenêtres de quota ou l’état de l’authentification. Ces appels sont peu fréquents, mais sollicitent tout de même les API des fournisseurs.

Consultez CLI des modèles.

Résumé de protection de la Compaction

Le mécanisme de protection de la Compaction peut résumer l’historique de la session à l’aide du modèle actuel, ce qui appelle les API du fournisseur lorsqu’il s’exécute.

Consultez Gestion des sessions et Compaction.

Analyse / sondage des modèles

openclaw models scan peut sonder les modèles OpenRouter et utilise OPENROUTER_API_KEY lorsque le sondage est activé.

Consultez CLI des modèles.

Conversation vocale

Le mode de conversation vocale peut appeler ElevenLabs lorsqu’il est configuré : ELEVENLABS_API_KEY ou talk.providers.elevenlabs.apiKey.

Consultez Mode de conversation vocale.

Skills (API tierces)

Les Skills peuvent stocker une apiKey dans skills.entries.<name>.apiKey. Si une Skill utilise cette clé avec une API externe, le coût dépend du fournisseur de la Skill.

Consultez Skills.

Ressources connexes

• Utilisation des tokens et coûts
• Mise en cache des invites
• Suivi de l’utilisation