---
read_when:
    - أنت تربط واجهات استخدام/حصص المزوّد
    - تحتاج إلى شرح سلوك تتبع الاستخدام أو متطلبات المصادقة
summary: واجهات تتبع الاستخدام ومتطلبات بيانات الاعتماد
title: تتبع الاستخدام
x-i18n:
    generated_at: "2026-05-06T07:51:56Z"
    model: gpt-5.5
    provider: openai
    source_hash: 14210813bf3c078a1323b1560a1a3da586f55880e05a9b310e1b6a2d5490f956
    source_path: concepts/usage-tracking.md
    workflow: 16
---

## ما هو

- يجلب استخدام/حصة المزوّد مباشرة من نقاط نهاية الاستخدام الخاصة به.
- لا توجد تكاليف تقديرية؛ فقط النوافذ التي يبلّغ عنها المزوّد.
- يتم توحيد مخرجات الحالة المقروءة للبشر إلى `X% left`، حتى عندما تبلّغ
  واجهة API المنبع عن الحصة المستهلكة، أو الحصة المتبقية، أو الأعداد الخام فقط.
- يمكن لـ `/status` على مستوى الجلسة و`session_status` الرجوع إلى أحدث
  إدخال استخدام في النص المسجل عندما تكون لقطة الجلسة الحية محدودة. يملأ ذلك
  الرجوع عدّادات الرموز/التخزين المؤقت المفقودة، ويمكنه استعادة تسمية نموذج
  وقت التشغيل النشط، ويفضّل الإجمالي الأكبر الموجّه للموجه عندما تكون بيانات
  الجلسة الوصفية مفقودة أو أصغر. تظل القيم الحية غير الصفرية الموجودة هي الغالبة.

## أين يظهر

- `/status` في الدردشات: بطاقة حالة غنية بالرموز التعبيرية تتضمن رموز الجلسة + التكلفة التقديرية (مفتاح API فقط). يظهر استخدام المزوّد لـ **مزوّد النموذج الحالي** عند توفره كنافذة موحّدة بصيغة `X% left`.
- `/usage off|tokens|full` في الدردشات: تذييل استخدام لكل استجابة (يعرض OAuth الرموز فقط).
- `/usage cost` في الدردشات: ملخص تكلفة محلي مجمّع من سجلات جلسات OpenClaw.
- CLI: يطبع `openclaw status --usage` تفصيلاً كاملاً لكل مزوّد.
- CLI: يطبع `openclaw channels list` لقطة الاستخدام نفسها إلى جانب إعداد المزوّد (استخدم `--no-usage` للتخطي).
- شريط قوائم macOS: قسم "الاستخدام" ضمن السياق (فقط إذا كان متاحاً).

## المزوّدون + بيانات الاعتماد

- **Anthropic (Claude)**: رموز OAuth في ملفات تعريف المصادقة.
- **GitHub Copilot**: رموز OAuth في ملفات تعريف المصادقة.
- **Gemini CLI**: رموز OAuth في ملفات تعريف المصادقة.
  - يرجع استخدام JSON إلى `stats`؛ ويتم توحيد `stats.cached` إلى
    `cacheRead`.
- **OpenAI Codex**: رموز OAuth في ملفات تعريف المصادقة (يُستخدم accountId عند وجوده).
- **MiniMax**: مفتاح API أو ملف تعريف مصادقة MiniMax OAuth. يتعامل OpenClaw مع
  `minimax`، و`minimax-cn`، و`minimax-portal` على أنها سطح حصة MiniMax نفسه،
  ويفضّل MiniMax OAuth المخزّن عند وجوده، وإلا يرجع إلى
  `MINIMAX_CODE_PLAN_KEY`، أو `MINIMAX_CODING_API_KEY`، أو `MINIMAX_API_KEY`.
  يستنتج استطلاع الاستخدام مضيف Coding Plan من `models.providers.minimax-portal.baseUrl`
  أو `models.providers.minimax.baseUrl` عند تهيئته، وإلا يستخدم
  مضيف MiniMax CN.
  تعني حقول MiniMax الخام `usage_percent` / `usagePercent` الحصة **المتبقية**،
  لذلك يعكسها OpenClaw قبل العرض؛ وتكون الحقول المعتمدة على العدّ هي الغالبة عند
  وجودها.
  - تأتي تسميات نافذة خطة الترميز من حقول الساعات/الدقائق لدى المزوّد عند
    وجودها، ثم ترجع إلى نطاق `start_time` / `end_time`.
  - إذا أعادت نقطة نهاية خطة الترميز `model_remains`، يفضّل OpenClaw إدخال
    نموذج الدردشة، ويستنتج تسمية النافذة من الطوابع الزمنية عند غياب حقول
    `window_hours` / `window_minutes` الصريحة، ويتضمن اسم النموذج في تسمية الخطة.
- **Xiaomi MiMo**: مفتاح API عبر env/config/auth store (`XIAOMI_API_KEY`).
- **z.ai**: مفتاح API عبر env/config/auth store.

يُخفى الاستخدام عندما يتعذر حل مصادقة استخدام مزوّد قابلة للاستخدام. يمكن للمزوّدين
توفير منطق مصادقة استخدام خاص بالـ Plugin؛ وإلا يرجع OpenClaw إلى
مطابقة بيانات اعتماد OAuth/مفتاح API من ملفات تعريف المصادقة، أو متغيرات البيئة،
أو الإعدادات.

## ذو صلة

- [استخدام الرموز والتكاليف](/ar/reference/token-use)
- [استخدام API والتكاليف](/ar/reference/api-usage-costs)
- [التخزين المؤقت للموجهات](/ar/reference/prompt-caching)