الانتقال إلى المحتوى الرئيسي

​
استخدام الرموز والتكاليف

يتتبع OpenClaw الرموز، وليس الأحرف. تختلف الرموز حسب النموذج، لكن معظم النماذج بأسلوب OpenAI يبلغ متوسطها نحو 4 أحرف لكل رمز في النص الإنجليزي.

​
كيف يُبنى موجه النظام

يجمع OpenClaw موجه النظام الخاص به في كل تشغيل. ويتضمن:
  • قائمة الأدوات + أوصافًا قصيرة
  • قائمة Skills (البيانات الوصفية فقط؛ تُحمَّل التعليمات عند الطلب باستخدام read)
  • تعليمات التحديث الذاتي
  • ملفات مساحة العمل + التمهيد (AGENTS.md وSOUL.md وTOOLS.md وIDENTITY.md وUSER.md وHEARTBEAT.md وBOOTSTRAP.md عند كونها جديدة، بالإضافة إلى MEMORY.md عند وجوده أو memory.md كبديل بأحرف صغيرة). تُقتطع الملفات الكبيرة بواسطة agents.defaults.bootstrapMaxChars (الافتراضي: 20000)، ويُحد سقف إجمالي حقن التمهيد بواسطة agents.defaults.bootstrapTotalMaxChars (الافتراضي: 150000). تُحمَّل ملفات memory/*.md عند الطلب عبر أدوات الذاكرة ولا تُحقن تلقائيًا.
  • الوقت (UTC + المنطقة الزمنية للمستخدم)
  • وسوم الرد + سلوك heartbeat
  • بيانات وصفية وقت التشغيل (المضيف/نظام التشغيل/النموذج/التفكير)
راجع التفصيل الكامل في موجه النظام.

​
ما الذي يُحتسب ضمن نافذة السياق

كل ما يتلقاه النموذج يُحتسب ضمن حد السياق:
  • موجه النظام (كل الأقسام المذكورة أعلاه)
  • سجل المحادثة (رسائل المستخدم + المساعد)
  • استدعاءات الأدوات ونتائج الأدوات
  • المرفقات/النصوص المفرغة (الصور، والصوت، والملفات)
  • ملخصات الضغط وعناصر التقليم
  • مغلفات المزوّد أو ترويسات الأمان (غير مرئية، لكنها ما تزال محتسبة)
بالنسبة إلى الصور، يقوم OpenClaw بتقليص أبعاد حمولات صور النصوص المفرغة/الأدوات قبل استدعاءات المزوّد. استخدم agents.defaults.imageMaxDimensionPx (الافتراضي: 1200) لضبط هذا السلوك:
  • تؤدي القيم الأقل عادةً إلى تقليل استخدام رموز الرؤية وحجم الحمولة.
  • تحافظ القيم الأعلى على مزيد من التفاصيل المرئية للقطات الشاشة الثقيلة على OCR/واجهة المستخدم.
للحصول على تفصيل عملي (لكل ملف مُحقن، والأدوات، والمهارات، وحجم موجه النظام)، استخدم /context list أو /context detail. راجع السياق.

​
كيفية رؤية استخدام الرموز الحالي

استخدم ما يلي في الدردشة:
  • /status → بطاقة حالة غنية بالإيموجي تعرض نموذج الجلسة، واستخدام السياق، ورموز الإدخال/الإخراج لآخر استجابة، والتكلفة التقديرية (لمفتاح API فقط).
  • /usage off|tokens|full → يضيف تذييل استخدام لكل استجابة إلى كل رد.
    • يُحفَظ لكل جلسة (مخزَّنًا باسم responseUsage).
    • تخفي مصادقة OAuth التكلفة (الرموز فقط).
  • /usage cost → يعرض ملخصًا محليًا للتكلفة من سجلات جلسات OpenClaw.
أسطح أخرى:
  • TUI/Web TUI: كل من /status و/usage مدعومان.
  • CLI: يعرض openclaw status --usage وopenclaw channels list نوافذ حصص المزوّد الموحّدة (X% left، وليس تكاليف لكل استجابة). مزوّدو نافذة الاستخدام الحاليون: Anthropic وGitHub Copilot وGemini CLI، وOpenAI Codex وMiniMax وXiaomi وz.ai.
تقوم أسطح الاستخدام بتوحيد الأسماء البديلة الشائعة للحقول الأصلية لدى المزوّد قبل العرض. وبالنسبة إلى حركة Responses لعائلة OpenAI، يشمل ذلك كلًا من input_tokens / output_tokens وprompt_tokens / completion_tokens، بحيث لا تؤدي أسماء الحقول الخاصة بالنقل إلى تغيير /status أو /usage أو ملخصات الجلسات. كما يتم أيضًا توحيد استخدام JSON في Gemini CLI: يأتي نص الرد من response، ويتم ربط stats.cached بـ cacheRead مع استخدام stats.input_tokens - stats.cached عندما يهمل CLI توفير حقل stats.input صريح. وبالنسبة إلى حركة Responses الأصلية لعائلة OpenAI، تُوحَّد أيضًا الأسماء البديلة للاستخدام في WebSocket/SSE بالطريقة نفسها، وتعود المجاميع إلى الإدخال + الإخراج الموحَّدين عندما يكون total_tokens مفقودًا أو يساوي 0. عندما تكون لقطة الجلسة الحالية قليلة البيانات، يمكن لـ /status وsession_status أيضًا استعادة عدّادات الرموز/التخزين المؤقت ووسم نموذج وقت التشغيل النشط من أحدث سجل استخدام في النص المفرغ. تظل القيم الحية غير الصفرية الحالية ذات أولوية على قيم الرجوع إلى النص المفرغ، ويمكن أن تفوز أيضًا المجاميع الأكبر الموجّهة نحو الموجه في النص المفرغ عندما تكون المجاميع المخزنة مفقودة أو أصغر. تأتي مصادقة الاستخدام لنوافذ حصص المزوّد من الخطافات الخاصة بالمزوّد عند توفرها؛ وإلا يعود OpenClaw إلى مطابقة بيانات اعتماد OAuth/مفتاح API من ملفات تعريف المصادقة، أو البيئة، أو التهيئة.

​
تقدير التكلفة (عند عرضه)

تُقدَّر التكاليف من إعداد تسعير النموذج لديك: 
models.providers.<provider>.models[].cost
هذه القيم هي دولار أمريكي لكل 1 مليون رمز لكل من input وoutput وcacheRead و cacheWrite. إذا كانت التسعيرة مفقودة، فسيعرض OpenClaw الرموز فقط. لا تعرض رموز OAuth أي تكلفة بالدولار.

​
تأثير TTL للتخزين المؤقت والتقليم

لا ينطبق التخزين المؤقت لموجه المزوّد إلا ضمن نافذة TTL الخاصة بالتخزين المؤقت. يمكن لـ OpenClaw اختياريًا تشغيل تقليم cache-ttl: إذ يقلّم الجلسة بعد انتهاء TTL للتخزين المؤقت، ثم يعيد تعيين نافذة التخزين المؤقت بحيث يمكن للطلبات اللاحقة إعادة استخدام السياق المخزّن حديثًا بدلًا من إعادة تخزين السجل الكامل مؤقتًا. يساعد هذا في إبقاء تكاليف كتابة التخزين المؤقت أقل عندما تبقى الجلسة خاملة بعد تجاوز TTL. يمكنك ضبطه في تهيئة Gateway ومراجعة تفاصيل السلوك في تقليم الجلسة. يمكن لـ heartbeat إبقاء التخزين المؤقت دافئًا عبر فترات الخمول. إذا كان TTL للتخزين المؤقت في نموذجك هو 1h، فإن ضبط فترة heartbeat على ما يقل قليلًا عن ذلك (مثل 55m) يمكن أن يتجنب إعادة تخزين الموجه الكامل مؤقتًا، مما يقلل تكاليف كتابة التخزين المؤقت. في إعدادات الوكلاء المتعددين، يمكنك الاحتفاظ بتهيئة نموذج مشتركة واحدة وضبط سلوك التخزين المؤقت لكل وكيل عبر agents.list[].params.cacheRetention. للحصول على دليل كامل لكل خيار، راجع التخزين المؤقت للموجه. بالنسبة إلى تسعير Anthropic API، تكون قراءات التخزين المؤقت أرخص بكثير من رموز الإدخال، بينما تُحتسب كتابات التخزين المؤقت بمضاعف أعلى. راجع تسعير التخزين المؤقت للموجه لدى Anthropic للحصول على أحدث الأسعار ومضاعفات TTL: https://docs.anthropic.com/docs/build-with-claude/prompt-caching

​
مثال: إبقاء تخزين مؤقت لمدة 1 ساعة دافئًا باستخدام heartbeat

agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long"
    heartbeat:
      every: "55m"

​
مثال: حركة مختلطة مع استراتيجية تخزين مؤقت لكل وكيل

agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long" # خط أساس افتراضي لمعظم الوكلاء
  list:
    - id: "research"
      default: true
      heartbeat:
        every: "55m" # إبقاء التخزين المؤقت الطويل دافئًا للجلسات العميقة
    - id: "alerts"
      params:
        cacheRetention: "none" # تجنب كتابات التخزين المؤقت للإشعارات المتقطعة
يُدمج agents.list[].params فوق params الخاصة بالنموذج المحدد، بحيث يمكنك تجاوز cacheRetention فقط مع إبقاء الإعدادات الافتراضية الأخرى للنموذج كما هي.

​
مثال: تمكين ترويسة النسخة التجريبية لسياق Anthropic بحجم 1M

نافذة السياق 1M من Anthropic محمية حاليًا كميزة تجريبية. يمكن لـ OpenClaw حقن قيمة anthropic-beta المطلوبة عندما تقوم بتمكين context1m على نماذج Opus أو Sonnet المدعومة. 
agents:
  defaults:
    models:
      "anthropic/claude-opus-4-6":
        params:
          context1m: true
يُربط هذا بترويسة Anthropic التجريبية context-1m-2025-08-07. ينطبق هذا فقط عندما تكون context1m: true مضبوطة على إدخال ذلك النموذج. المتطلب: يجب أن تكون بيانات الاعتماد مؤهلة لاستخدام السياق الطويل (فوترة مفتاح API، أو مسار Claude-login الخاص بـ OpenClaw مع تفعيل Extra Usage). إذا لم تكن كذلك، فإن Anthropic تستجيب بـ HTTP 429: rate_limit_error: Extra usage is required for long context requests. إذا قمت بمصادقة Anthropic باستخدام رموز OAuth/الاشتراك (sk-ant-oat-*)، فإن OpenClaw يتخطى ترويسة النسخة التجريبية context-1m-* لأن Anthropic ترفض حاليًا هذا الدمج مع HTTP 401.

​
نصائح لتقليل ضغط الرموز

  • استخدم /compact لتلخيص الجلسات الطويلة.
  • قلّص مخرجات الأدوات الكبيرة في مسارات عملك.
  • اخفض agents.defaults.imageMaxDimensionPx للجلسات الكثيفة بلقطات الشاشة.
  • اجعل أوصاف Skills قصيرة (تُحقن قائمة Skills في الموجه).
  • فضّل النماذج الأصغر للأعمال المطولة والاستكشافية.
راجع Skills لمعرفة الصيغة الدقيقة لعبء قائمة المهارات.