استخدام الرموز المميزة والتكاليف
يتتبع OpenClaw الرموز المميزة (Tokens)، وليس الأحرف. الرموز المميزة خاصة بالنموذج المستخدم، لكن معظم نماذج OpenAI تبلغ في المتوسط ~4 أحرف لكل رمز مميز للنص الإنجليزي.
كيفية بناء مطالبة النظام
يقوم OpenClaw بتجميع مطالبة النظام الخاصة به في كل تشغيل. تتضمن:
- قائمة الأدوات + أوصاف قصيرة
- قائمة المهارات (البيانات الوصفية فقط؛ يتم تحميل التعليمات عند الطلب باستخدام
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يعرضان نوافذ حصة المزود (وليس التكاليف لكل استجابة).
تقدير التكلفة (عند العرض)
يتم تقدير التكاليف من تكوين تسعير النموذج الخاص بك:
models.providers.<provider>.models[].cost
هذه هي الدولار الأمريكي لكل مليون رمز مميز لـ input, output, cacheRead, و cacheWrite. إذا كانت الأسعار مفقودة، يُظهر OpenClaw الرموز المميزة فقط. رموز OAuth لا تُظهر تكلفة بالدولار أبداً.
مهلة صلاحية التخزين المؤقت وتأثير التقليم
التخزين المؤقت لمطالبات المزود ينطبق فقط ضمن نافذة مهلة صلاحية التخزين المؤقت. يمكن لـ OpenClaw تشغيل تقليم مهلة صلاحية التخزين المؤقت اختيارياً: حيث يقوم بتقليم الجلسة بمجرد انتهاء مهلة صلاحية التخزين المؤقت، ثم يعيد تعيين نافذة التخزين المؤقت بحيث يمكن للطلبات اللاحقة إعادة استخدام السياق المخزن حديثاً بدلاً من إعادة تخزين السجل الكامل. هذا يحافظ على تكاليف كتابة التخزين المؤقت منخفضة عندما تكون الجلسة خاملة بعد انتهاء المهلة. قم بتكوينه في تكوين البوابة وراجع تفاصيل السلوك في تقليم الجلسة. يمكن لنبض القلب (Heartbeat) الحفاظ على التخزين المؤقت دافئاً عبر فترات الخمول. إذا كانت مهلة صلاحية التخزين المؤقت لنموذجك هي 1h، فإن تعيين فاصل نبض القلب أقل من ذلك بقليل (مثلاً، 55m) يمكن أن يتجنب إعادة تخزين المطالبة الكاملة، مما يقلل تكاليف كتابة التخزين المؤقت. في إعدادات الوكيل المتعدد، يمكنك الاحتفاظ بتكوين نموذج مشترك واحد وضبط سلوك التخزين المؤقت لكل وكيل باستخدام agents.list[].params.cacheRetention. للحصول على دليل مفصل لكل عنصر تحكم، انظر التخزين المؤقت للمطالبات. بالنسبة لتسعير Anthropic API، فإن قراءات التخزين المؤقت أرخص بكثير من رموز الإدخال، بينما يتم فوترة كتابات التخزين المؤقت بمضاعف أعلى. راجع تسعير التخزين المؤقت للمطالبات من Anthropic للحصول على أحدث الأسعار ومضاعفات مهلة الصلاحية: https://docs.anthropic.com/docs/build-with-claude/prompt-caching
مثال: الحفاظ على تخزين مؤقت لمدة ساعة دافئاً باستخدام نبض القلب
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
هذا يُرسم إلى رأس تجربة بيتا context-1m-2025-08-07 الخاص بـ Anthropic. ينطبق هذا فقط عند تعيين context1m: true على إدخال ذلك النموذج. المتطلب: يجب أن يكون الاعتماد مؤهلاً لاستخدام السياق الطويل (فوترة مفتاح API، أو اشتراك مع تمكين الاستخدام الإضافي). إذا لم يكن كذلك، يستجيب 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للجلسات الغنية بصور الشاشة. - اجعل أوصاف المهارات قصيرة (يتم حقن قائمة المهارات في المطالبة).
- فضل النماذج الأصغر للعمل الاستكشافي المطول.
انظر المهارات للحصول على صيغة الحساب الدقيقة لحمل قائمة المهارات.