تتبع الاستخدام

# ما هو

• يجلب استخدام/حصة المزوّد مباشرة من نقاط نهاية الاستخدام الخاصة به.
• لا توجد تكاليف تقديرية؛ فقط النوافذ التي يبلّغ عنها المزوّد.
• يتم توحيد مخرجات الحالة المقروءة للبشر إلى 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 من ملفات تعريف المصادقة، أو متغيرات البيئة، أو الإعدادات.

# ذو صلة

• استخدام الرموز والتكاليف
• استخدام API والتكاليف
• التخزين المؤقت للموجهات