Suivi de l'utilisation

Ce que c’est

• Récupère le quota d’utilisation du provider directement depuis leurs points de terminaison d’utilisation.
• Pas de coûts estimés ; uniquement les fenêtres de quota signalées par le provider ou les résumés de l’état du compte.
• La sortie de l’état de la fenêtre de quota lisible par l’homme est normalisée en X% left, même lorsqu’une API en amont signale le quota consommé, le quota restant ou uniquement des comptes bruts. Les providers sans fenêtres de quota réinitialisables peuvent afficher le texte de résumé du provider à la place, tel qu’un solde.
• Les /status et session_status au niveau de la session peuvent revenir à la dernière entrée d’utilisation de la transcription lorsque l’instantané de la session en direct est clairsemé. Ce retour remplit les compteurs de jetons/cache manquants, peut récupérer l’étiquette du modèle d’exécution actif et préfère le total orienté prompt le plus important lorsque les métadonnées de session sont manquantes ou plus petites. Les valeurs actives non nulles existantes l’emportent toujours.

Où cela apparaît

• /status dans les chats : carte d’état riche en émojis avec des jetons de session + coût estimé (clé API uniquement). L’utilisation du provider s’affiche pour le provider de modèle actuel lorsque disponible sous forme de fenêtre normalisée X% left ou de texte de résumé du provider.
• /usage off|tokens|full dans les chats : pied de page d’utilisation par réponse (OAuth affiche uniquement les jetons).
• /usage cost dans les chats : résumé des coûts locaux agrégé à partir des journaux de session OpenClaw.
• CLI : openclaw status --usage imprime une ventilation complète par provider.
• CLI : openclaw channels list imprime le même instantané d’utilisation à côté de la configuration du provider (utilisez --no-usage pour ignorer).
• Barre de menu macOS : section “Utilisation” sous Contexte (uniquement si disponible).

Providers + identifiants

• Anthropic (Claude) : jetons OAuth dans les profils d’authentification.
• GitHub Copilot : jetons OAuth dans les profils d’authentification.
• Gemini CLI : jetons OAuth dans les profils d’authentification.
  • L’utilisation JSON revient à stats ; stats.cached est normalisé dans cacheRead.
• OpenAI Codex : jetons OAuth dans les profils d’authentification (accountId utilisé si présent).
• MiniMax : clé API ou profil d’authentification MiniMax OAuth. OpenClaw traite MiniMaxAPIMiniMaxOAuthOpenClawminimax, minimax-cn et minimax-portalMiniMaxMiniMaxOAuth comme la même surface de quota MiniMax, privilégie le MiniMax OAuth stocké lorsqu’il est présent, et sinon revient à 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 de models.providers.minimax-portal.baseUrl ou models.providers.minimax.baseUrlMiniMaxMiniMax lorsqu’ils sont configurés, et utilise sinon l’hôte MiniMax CN. Les champs bruts usage_percent / usagePercentOpenClaw de MiniMax signifient le quota restant, donc OpenClaw les inverse avant l’affichage ; les champs basés sur le nombre prévalent lorsqu’ils sont présents.
  • Les étiquettes de fenêtre du plan de codage proviennent des champs heures/minutes du provider lorsqu’ils sont présents, puis reviennent à la plage start_time / end_time.
  • Si le endpoint du plan de codage renvoie model_remainsOpenClaw, OpenClaw privilégie l’entrée du modèle de chat, déduit l’étiquette de la fenêtre à partir des horodatages lorsque les champs explicites window_hours / window_minutes sont absents, et inclut le nom du modèle dans l’étiquette du plan.
• Xiaomi MiMo : clé API via env/config/auth store (XiaomiAPIXIAOMI_API_KEY).
• z.ai : clé API via env/config/auth store.
• DeepSeek : clé API via env/config/auth store (DEEPSEEK_API_KEY). OpenClaw appelle le endpoint de solde de DeepSeek et affiche le solde signalé par le provider sous forme de texte au lieu d’une fenêtre de quota de pourcentage restant.

L’utilisation est masquée lorsqu’aucune auth d’utilisation de provider utilisable ne peut être résolue. Les providers peuvent fournir une logique d’auth d’utilisation spécifique au plugin ; sinon OpenClaw revient à faire correspondre les identifiants OAuth/clé API à partir des profils d’auth, des variables d’environnement ou de la config.

Connexes

• Utilisation et coûts des jetons
• Utilisation et coûts de l’API
• Mise en cache du prompt