Suivi de l’utilisation

​

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.

​

Historique des coûts Anthropic et OpenAI

• 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.

​

Mode par défaut du pied de page d’utilisation

{
  "messages": {
    "responseUsage": "tokens",
    // ou : { "default": "off", "discord": "full" }
  },
}

​

Trois états de session distincts

​

Priorité

​

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

​

Configuration

​

Pied de page personnalisé pour /usage full

{
  "messages": {
    "usageTemplate": "~/.openclaw/usage-footer.json"
  }
}

{
  "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

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "<name>": "low-to-high glyphs" }, // chaîne (1 glyphe/caractère) ou tableau
  "aliases": { "<table>": { "<value>": "<label>" } },
  "output": {
    "sep": "", // concatène les éléments conservés
    "default": [/* éléments */], // valeur de repli pour toute surface
    "surfaces": {
      "discord": [/* éléments */],
      "telegram": [/* éléments */],
    },
  },
}

​

Chemins du contrat

​

Verbes

​

Formes des éléments

• { "text": "📚 {context.max_tokens|num}" } : texte littéral + interpolation.
• { "when": "<path>", "text": "..." } : affichage uniquement si le chemin est vrai.
• { "map": "<path>", "cases": { "true": "⚡", "false": "🐌" } } : conversion d’une valeur en glyphe (un cas _default couvre les valeurs sans correspondance).
• { "each": "<array-path>", "item": "{label}" } : parcours d’un chemin contenant un tableau (aucun chemin du contrat actuel n’est un tableau).

​

Exemple

{
  "schema": "openclaw.usageBar.v1",
  "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿" },
  "aliases": { "reasoning": { "medium": "🌗", "high": "🌕" } },
  "output": {
    "surfaces": {
      "discord": [
        { "text": "{model.display_name}" },
        { "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}",
        },
      ],
    },
  },
}

​

Fournisseurs et identifiants

• Anthropic (Claude) : jetons OAuth dans les profils d’identification. Si le jeton OAuth ne dispose pas de la portée user:profile, repli sur une session web claude.ai (CLAUDE_AI_SESSION_KEY, CLAUDE_WEB_SESSION_KEY ou un cookie sessionKey= dans CLAUDE_WEB_COOKIE) lorsqu’elle est définie. Les limites propres aux modèles ainsi que les dépenses et budgets mensuels d’utilisation supplémentaire activée sont inclus lorsqu’Anthropic les communique. Une clé explicite de l’API d’administration Anthropic, ou un profil de fournisseur sk-ant-admin... détecté automatiquement, affiche à la place le coût de l’organisation sur 30 jours et l’historique de l’API Messages.
• ClawRouter : clé API (CLAWROUTER_API_KEY). Affiche une fenêtre budgétaire mensuelle et un budget typé en USD lorsqu’ils sont configurés ; sinon, affiche les dépenses cumulées et un récapitulatif des requêtes, jetons et coûts.
• DeepSeek : clé API via l’environnement, la configuration ou le magasin d’identifiants (DEEPSEEK_API_KEY). Affiche le solde de chaque devise communiqué par le fournisseur.
• GitHub Copilot : jetons OAuth dans les profils d’identification.
• Gemini CLI : jetons OAuth dans les profils d’identification.
• MiniMax : clé API ou profil d’identification OAuth MiniMax. OpenClaw considère minimax, minimax-cn et minimax-portal comme une même surface de quota MiniMax, privilégie les identifiants OAuth MiniMax enregistrés lorsqu’ils sont présents, puis se replie sur MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY ou MINIMAX_API_KEY. L’interrogation de l’utilisation déduit l’hôte de l’offre Coding Plan à partir de models.providers.minimax-portal.baseUrl ou de models.providers.minimax.baseUrl lorsqu’il est configuré ; sinon, elle utilise l’hôte MiniMax CN. Les champs bruts usage_percent / usagePercent de MiniMax représentent le quota restant ; OpenClaw les inverse donc avant l’affichage. Les champs basés sur un nombre sont prioritaires lorsqu’ils sont présents.
  • Les libellés des fenêtres proviennent des champs d’heures ou de minutes du fournisseur lorsqu’ils sont présents, puis se replient sur l’intervalle start_time / end_time.
  • Si le point de terminaison de l’offre de codage renvoie model_remains, OpenClaw privilégie l’entrée du modèle de discussion, déduit le libellé 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 le libellé de l’offre.
• OpenAI (offre Codex/ChatGPT) : jetons OAuth dans les profils d’identification (en-tête ChatGPT-Account-Id envoyé lorsqu’un identifiant de compte est présent). Affiche l’offre ChatGPT, les fenêtres Codex réinitialisables et un solde de crédits lorsqu’il est communiqué. Les crédits restent des crédits du fournisseur ; OpenClaw ne les présente pas comme des dollars. OPENAI_ADMIN_KEY ajoute le coût de l’organisation sur 30 jours et l’historique d’utilisation des complétions lorsque la clé dispose d’un accès au tableau de bord d’utilisation. Les identifiants d’inférence ne sont jamais transmis aux API de l’organisation.
• OpenRouter : clé API ou clé API adossée à OAuth (OPENROUTER_API_KEY ou un profil d’identification). Combine le point de terminaison des crédits du compte avec celui du quota de la clé, afin d’afficher le solde et les dépenses du compte, le budget de la clé et l’utilisation quotidienne, hebdomadaire ou mensuelle lorsque les identifiants permettent d’y accéder. Chaque point de terminaison peut enrichir l’instantané indépendamment.
• Venice : clé API via l’environnement, la configuration ou le magasin d’identifiants (VENICE_API_KEY). Affiche les soldes en USD et en DIEM, ainsi que l’utilisation de l’allocation DIEM pour l’époque lorsqu’elle est communiquée.
• Xiaomi MiMo : deux surfaces d’utilisation distinctes. Le paiement à l’usage emploie une clé API (XIAOMI_API_KEY) ; l’offre Token Plan utilise une clé distincte (XIAOMI_TOKEN_PLAN_API_KEY). Aucune ne communique actuellement de fenêtres de quota.
• z.ai : clé API via l’environnement, la configuration ou le magasin d’identifiants (ZAI_API_KEY ou Z_AI_API_KEY).

​

Liens associés

• Utilisation et coûts des jetons
• Utilisation et coûts de l’API
• Mise en cache des prompts
• Barre des menus