Suivi de l’utilisation

# Ce que c’est

• Récupère l’utilisation/le quota des fournisseurs directement depuis leurs endpoints d’utilisation.
• Aucun coût estimé ; uniquement les fenêtres rapportées par le fournisseur.
• La sortie d’état lisible par un humain est normalisée en X% left, même lorsqu’une API amont rapporte le quota consommé, le quota restant ou uniquement des comptages bruts.
• /status au niveau de la session et session_status peuvent se rabattre sur la dernière entrée d’utilisation de la transcription lorsque l’instantané de session en direct est incomplet. Ce repli renseigne les compteurs de tokens/cache manquants, peut récupérer le libellé du modèle d’exécution actif, et préfère le total orienté prompt le plus élevé lorsque les métadonnées de session sont absentes ou plus faibles. Les valeurs non nulles en direct existantes restent prioritaires.

# Où cela apparaît

• /status dans les discussions : carte d’état enrichie d’emojis avec tokens de session + coût estimé (clé API uniquement). L’utilisation du fournisseur s’affiche pour le fournisseur du modèle actuel lorsqu’elle est disponible sous forme de fenêtre normalisée X% left.
• /usage off|tokens|full dans les discussions : pied de page d’utilisation par réponse (OAuth affiche uniquement les tokens).
• /usage cost dans les discussions : résumé local des coûts agrégé depuis les journaux de session OpenClaw.
• CLI : openclaw status --usage affiche une ventilation complète par fournisseur.
• CLI : openclaw channels list affiche le même instantané d’utilisation avec la configuration du fournisseur (utilisez --no-usage pour l’ignorer).
• Barre de menus macOS : section « Usage » sous Contexte (uniquement si disponible).

# Fournisseurs + identifiants

• Anthropic (Claude) : tokens OAuth dans les profils d’authentification.
• GitHub Copilot : tokens OAuth dans les profils d’authentification.
• Gemini CLI : tokens OAuth dans les profils d’authentification.
  • L’utilisation JSON se rabat sur stats ; stats.cached est normalisé en cacheRead.
• OpenAI Codex : tokens OAuth dans les profils d’authentification (accountId utilisé lorsqu’il est présent).
• MiniMax : clé API ou profil d’authentification OAuth MiniMax. OpenClaw traite minimax, minimax-cn et minimax-portal comme la même surface de quota MiniMax, privilégie l’OAuth MiniMax stocké lorsqu’il est présent, puis se rabat sinon sur MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY ou MINIMAX_API_KEY. L’interrogation de l’utilisation déduit l’hôte du Coding Plan depuis models.providers.minimax-portal.baseUrl ou models.providers.minimax.baseUrl lorsqu’il est configuré, et utilise sinon l’hôte MiniMax CN. Les champs bruts usage_percent / usagePercent de MiniMax indiquent le quota restant, donc OpenClaw les inverse avant l’affichage ; les champs basés sur des comptages sont prioritaires lorsqu’ils sont présents.
  • Les libellés de fenêtre du Coding Plan proviennent des champs heures/minutes du fournisseur lorsqu’ils sont présents, puis se rabattent sur l’intervalle start_time / end_time.
  • Si l’endpoint du Coding Plan renvoie model_remains, OpenClaw privilégie l’entrée du modèle de discussion, déduit le libellé de fenêtre depuis les horodatages lorsque les champs explicites window_hours / window_minutes sont absents, et inclut le nom du modèle dans le libellé du forfait.
• Xiaomi MiMo : clé API via l’environnement/la configuration/le magasin d’authentification (XIAOMI_API_KEY).
• z.ai : clé API via l’environnement/la configuration/le magasin d’authentification.

L’utilisation est masquée lorsqu’aucune authentification d’utilisation fournisseur exploitable ne peut être résolue. Les fournisseurs peuvent fournir une logique d’authentification d’utilisation propre au Plugin ; sinon, OpenClaw se rabat sur les identifiants OAuth/clé API correspondants depuis les profils d’authentification, les variables d’environnement ou la configuration.

# Connexe

• Utilisation des tokens et coûts
• Utilisation de l’API et coûts
• Mise en cache des prompts