--- read_when: - Vous connectez les interfaces d’utilisation et de quota du fournisseur - Vous devez expliquer le comportement du suivi de l’utilisation ou les exigences d’authentification. summary: Surfaces de suivi de l’utilisation et exigences relatives aux identifiants de connexion title: Suivi de l’utilisation x-i18n: generated_at: "2026-07-12T02:49:17Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: c413dcbe838d94c57ba3f6ef9609331e139de6d0abbdb3860753a519bd490314 source_path: concepts/usage-tracking.md workflow: 16 --- ## Présentation - Récupère l’utilisation et les quotas directement depuis le point de terminaison d’utilisation de chaque fournisseur. Aucune estimation de facturation du fournisseur : uniquement les noms de forfaits, fenêtres de quota, soldes, dépenses, budgets, historique des coûts quotidiens, attribution aux jetons/modèles ou résumés de l’état du compte communiqués par le fournisseur. - La sortie lisible des fenêtres de quota est normalisée sous la forme `X% restant`, même lorsqu’un fournisseur indique le quota consommé, le quota restant ou uniquement des valeurs brutes. Les fournisseurs sans fenêtres de quota réinitialisables affichent à la place un texte récapitulatif du fournisseur, par exemple un solde. - La commande `/status` au niveau de la session et l’outil `session_status` se rabattent sur le journal de transcription de la session lorsque l’instantané de session en direct ne contient pas les données de jetons ou de modèle. Ce mécanisme complète les compteurs de jetons et de cache manquants, peut retrouver le libellé du modèle d’exécution actif et privilégie le total orienté invite le plus élevé lorsque les métadonnées de session sont absentes ou indiquent une valeur inférieure (`totalTokensFresh !== true`, zéro ou une valeur inférieure à celle dérivée de la transcription). Les valeurs en direct non nulles prévalent toujours sur les valeurs de repli. ## Emplacements d’affichage - `/status` dans les conversations : carte d’état indiquant les jetons de la session et le coût estimé (uniquement pour les modèles utilisant une clé d’API). L’utilisation du fournisseur s’affiche pour le **fournisseur du modèle actuel** lorsqu’elle est disponible, sous la forme d’une fenêtre normalisée `X% restant` ou d’un texte récapitulatif du fournisseur. - `/usage off|tokens|full` dans les conversations : pied de page d’utilisation pour chaque réponse. - `/usage cost` dans les conversations : récapitulatif local des coûts, agrégé à partir des journaux de session OpenClaw. - CLI : `openclaw status --usage` affiche une ventilation complète de l’utilisation et des quotas par fournisseur. - CLI : `openclaw models status` répertorie les profils d’authentification OAuth/par jeton et affiche un récapitulatif des fenêtres d’utilisation à côté de chaque fournisseur qui en possède un. - Interface de contrôle : **Utilisation** affiche les cartes de forfait et de facturation du fournisseur au-dessus de l’analyse des jetons et des coûts estimés dérivée des sessions OpenClaw. Les identifiants de l’API d’administration Anthropic et OpenAI ajoutent les dépenses du jour, des 7 derniers jours et des 30 derniers jours communiquées par le fournisseur, ainsi que les tendances quotidiennes, les totaux de jetons, les principaux modèles et les catégories de coûts. - Interface de contrôle : la fenêtre contextuelle de l’anneau de contexte du champ de rédaction affiche l’**utilisation du forfait** pour les fournisseurs par abonnement — barres par fenêtre (5 heures, hebdomadaire, propre au modèle) avec les heures de réinitialisation, le forfait du fournisseur lorsqu’il est connu (par exemple `Max (20x)`) et les crédits d’utilisation supplémentaire. Les sessions facturées dans le cadre d’un forfait masquent les estimations monétaires par jeton ; les sessions facturées via l’API conservent `Coût estimé` et la ventilation des coûts par type. Les configurations de la CLI Claude Code (`claude-cli`) réutilisent la même utilisation d’abonnement Anthropic. - Barre de menus macOS : une section racine « Utilisation » apparaît sous Contexte lorsque des instantanés d’utilisation des fournisseurs sont disponibles. Consultez [Barre de menus](/fr/platforms/mac/menu-bar). `openclaw channels list` n’affiche plus l’utilisation des fournisseurs ; la commande oriente désormais les utilisateurs vers `openclaw status` ou `openclaw models list`. ## Historique des coûts Anthropic et OpenAI Les quotas d’abonnement et la facturation d’API correspondent à des interfaces distinctes du fournisseur : - Les identifiants d’abonnement ou de configuration Anthropic continuent d’afficher les fenêtres de quota Claude et les budgets facultatifs d’utilisation supplémentaire. Définissez `ANTHROPIC_ADMIN_KEY` ou `ANTHROPIC_ADMIN_API_KEY` pour afficher à la place l’historique des API Usage et Cost de l’organisation. Un identifiant de fournisseur Anthropic commençant par `sk-ant-admin` est détecté automatiquement. - OAuth OpenAI ChatGPT/Codex continue d’afficher le forfait, les fenêtres de quota et le solde de crédits. Définissez `OPENAI_ADMIN_KEY` pour afficher à la place l’historique des coûts et de l’utilisation des complétions de l’organisation ; vous pouvez également définir `OPENAI_PROJECT_ID` pour limiter les données à un seul projet. OpenClaw n’envoie jamais aux API d’organisation les identifiants d’inférence provenant de `OPENAI_API_KEY`, de la configuration du fournisseur ou des profils d’authentification, car ces clés peuvent appartenir à des points de terminaison personnalisés. Les identifiants d’administration sont prioritaires, car ils fournissent la facturation réelle de l’organisation. OpenClaw ne combine pas ces totaux communiqués par le fournisseur avec ses estimations locales de session ; les deux sections répondent volontairement à des questions différentes. ## Mode par défaut du pied de page d’utilisation `/usage off|tokens|full` définit le pied de page d’une session et ce choix est mémorisé pour cette session. `messages.responseUsage` initialise ce mode pour les sessions qui n’en ont pas choisi, afin que le pied de page puisse être activé par défaut sans saisir `/usage` à chaque fois. Définissez un mode pour tous les canaux ou une table par canal avec `default` comme valeur de repli : ```jsonc { "messages": { "responseUsage": "tokens", // ou : { "default": "off", "discord": "full" } }, } ``` Valeurs acceptées : `"off"`, `"tokens"`, `"full"` et l’ancien alias `"on"` (traité comme `"tokens"`). ### Trois états de session distincts Le champ `responseUsage` d’une session peut représenter trois états, chacun ayant une sémantique différente : | État | Valeur stockée | Mode effectif | | ---------------------------- | -------------------------------- | ------------------------------------------------------------------------------------ | | **Non défini / hérité** | `undefined` (absente) | Utilise la valeur par défaut de `messages.responseUsage`, puis `off`. | | **Désactivation explicite** | `"off"` (stockée) | Toujours désactivé ; une valeur par défaut active ne peut pas réactiver le pied de page. | | **Activation explicite** | `"tokens"` ou `"full"` (stockée) | Ce mode, quelle que soit la valeur par défaut de la configuration. | ### Priorité Mode effectif = remplacement de session → entrée de configuration du canal → `default` → `off`. Une commande explicite `/usage off` est **conservée** sous la valeur littérale `"off"` dans la session ; elle ne correspond pas à un état « non défini ». Une valeur par défaut active de `messages.responseUsage` ne peut pas réactiver le pied de page après sa désactivation explicite par l’utilisateur. ### Réinitialisation ou désactivation - `/usage off` force la désactivation du pied de page et conserve ce choix. Une valeur par défaut active configurée ne peut pas le remplacer. - `/usage reset` (alias : `default`, `inherit`, `inherited`, `clear`, `unpin`) efface le remplacement de session. La session **hérite** alors de la valeur par défaut effective de la configuration (`messages.responseUsage`). Si aucune valeur par défaut n’est configurée, le pied de page reste désactivé. - Une réinitialisation complète de la session (`/reset` ou `/new`) ou un renouvellement de session **conserve** la préférence explicite du mode d’utilisation, afin que le choix d’affichage de l’utilisateur persiste après les renouvellements de session. Seule la commande `/usage reset` (et ses alias) efface le remplacement. ### Comportement du basculement `/usage` sans argument parcourt les modes : désactivé → jetons → complet → désactivé. Le point de départ du cycle est le mode actuel **effectif** (le remplacement de session utilisant la valeur par défaut de la configuration lorsqu’il n’est pas défini), afin que le cycle corresponde toujours à ce que l’utilisateur voit actuellement dans le pied de page. ### Configuration Sans configuration, le comportement précédent est conservé : le pied de page reste désactivé jusqu’à l’utilisation de `/usage`. Utilisez `/usage reset` pour effacer un remplacement de session et hériter de nouveau de la valeur par défaut configurée. ## Pied de page personnalisé pour `/usage full` `/usage tokens` affiche toujours une simple ligne `Utilisation : X en entrée / Y en sortie` (avec les suffixes relatifs au cache et au coût estimé lorsqu’ils sont disponibles). Seule la commande `/usage full` affiche le pied de page plus riche décrit ci-dessous. `/usage full` affiche un pied de page compact intégré avec le modèle, le raisonnement, le mode rapide/lent, la fenêtre de contexte et le coût lorsque ces champs sont disponibles. Aucun fichier de modèle n’est requis pour le pied de page intégré. `messages.usageTemplate` est réservé aux mises en page personnalisées avancées. Sa valeur est un chemin de fichier JSON (prenant en charge `~`) ou un objet en ligne ; lorsqu’elle est valide, elle remplace le pied de page intégré. Un chemin de fichier est surveillé et rechargé à chaud lors des modifications. ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` Les modèles absents ou vides utilisent silencieusement le pied de page intégré. Les modèles configurés illisibles ou non valides (JSON incorrect ou structure ne contenant aucun élément affichable) utilisent également le pied de page intégré et émettent un avertissement à l’intention de l’opérateur. Pour créer des modèles personnalisés, partez de la structure intégrée, puis modifiez les parties que vous souhaitez changer : ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿", "block": "░▏▎▍▌▋▊▉█", "shade": "░▒▓█", "moon": "🌑🌘🌗🌖🌕", "level": "▁▂▃▄▅▆▇█", "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"], "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"], "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"], }, "aliases": { "models": { "claude-opus-4-6": "opus46", "claude-opus-4-8": "opus48", "claude-sonnet-4-6": "sonnet46", "claude-haiku-4-5": "haiku45", "gpt-5.5": "gpt5.5", }, "reasoning": { "off": "🌑", "minimal": "🌚", "low": "🌘", "medium": "🌗", "high": "🌕", "xhigh": "🌝", }, }, "output": { "sep": "", "default": [ { "text": "{model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": "🔄" } }, { "map": "model.is_override", "cases": { "true": "📌" } }, { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } }, { "when": "context.max_tokens", "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], "surfaces": { "discord": [ { "text": "-# -\n" }, { "text": "-# {model.provider}{identity.emoji|🤖}{model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": "🔄" } }, { "map": "model.is_override", "cases": { "true": "📌" } }, { "when": "model.reasoning", "text": "{model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": "⚡️", "false": "🐌" } }, { "when": "context.max_tokens", "text": " | 📚[{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Structure ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // chaîne (1 glyphe/caractère) ou tableau "aliases": { "": { "": "