---
read_when:
    - شرح استخدام الرموز المميزة والتكاليف أو نوافذ السياق
    - تصحيح سلوك نمو السياق أو Compaction
summary: كيف يبني OpenClaw سياق المطالبة ويبلغ عن استخدام الرموز والتكاليف
title: استخدام الرموز والتكاليف
x-i18n:
    generated_at: "2026-07-01T18:13:49Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 99e3de70aeb447bb58ae414c2c5908945e8173b9b8f2bf7e4c2eb9781657c44c
    source_path: reference/token-use.md
    workflow: 16
---

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

## كيف تُبنى مطالبة النظام

يجمع OpenClaw مطالبة النظام الخاصة به في كل تشغيل. وتشمل:

- قائمة الأدوات + أوصاف قصيرة
- قائمة Skills (البيانات الوصفية فقط؛ تُحمَّل التعليمات عند الطلب باستخدام `read`).
  تتلقى دورات Codex الأصلية كتلة Skills المضغوطة كتعليمات مطوّر تعاون
  محددة بنطاق الدورة؛ وتتلقاها الحزم الأخرى في سطح المطالبة العادي. وهي
  محدودة بواسطة `skills.limits.maxSkillsPromptChars`، مع تجاوز اختياري لكل
  وكيل عند `agents.list[].skillsLimits.maxSkillsPromptChars`.
- تعليمات التحديث الذاتي
- مساحة العمل + ملفات التمهيد (`AGENTS.md`، `SOUL.md`، `TOOLS.md`، `IDENTITY.md`، `USER.md`، `HEARTBEAT.md`، `BOOTSTRAP.md` عند كونها جديدة، إضافةً إلى `MEMORY.md` عند وجوده). لا تلصق دورات Codex الأصلية ملف `MEMORY.md` الخام من مساحة عمل الوكيل المكوّنة عندما تكون أدوات الذاكرة متاحة لتلك المساحة؛ بل تتضمن مؤشر ذاكرة صغيرًا في تعليمات مطوّر التعاون المحددة بنطاق الدورة وتستخدم أدوات الذاكرة عند الطلب. إذا كانت الأدوات معطلة، أو كان البحث في الذاكرة غير متاح، أو كانت مساحة العمل النشطة تختلف عن مساحة عمل ذاكرة الوكيل، يستخدم `MEMORY.md` مسار سياق الدورة العادي المحدود. لا يُحقن جذر `memory.md` بالأحرف الصغيرة؛ فهو مُدخل إصلاح قديم لـ `openclaw doctor --fix` عند إقرانه بـ `MEMORY.md`. تُقتطع الملفات الكبيرة المحقونة بواسطة `agents.defaults.bootstrapMaxChars` (الافتراضي: 20000)، ويُحدد إجمالي حقن التمهيد بواسطة `agents.defaults.bootstrapTotalMaxChars` (الافتراضي: 60000). لا تُعد ملفات `memory/*.md` اليومية جزءًا من مطالبة التمهيد العادية؛ فهي تبقى عند الطلب عبر أدوات الذاكرة في الدورات العادية، لكن تشغيلات النموذج عند إعادة الضبط/بدء التشغيل يمكن أن تسبق كتلة سياق بدء تشغيل لمرة واحدة بذاكرة يومية حديثة لتلك الدورة الأولى. تُقر أوامر الدردشة المجردة `/new` و`/reset` دون استدعاء النموذج. يتحكم `agents.defaults.startupContext` في تمهيد بدء التشغيل. مقتطفات AGENTS.md بعد Compaction منفصلة وتتطلب اشتراكًا صريحًا عبر `agents.defaults.compaction.postCompactionSections`.
- الوقت (UTC + المنطقة الزمنية للمستخدم)
- وسوم الرد + سلوك Heartbeat
- بيانات وصفية لوقت التشغيل (المضيف/نظام التشغيل/النموذج/التفكير)

راجع التفصيل الكامل في [مطالبة النظام](/ar/concepts/system-prompt).

عند توثيق بيانات الاعتماد أو مقتطفات المصادقة، استخدم
[اصطلاحات العنصر النائب للأسرار](/ar/reference/secret-placeholder-conventions)
لتجنب النتائج الإيجابية الكاذبة من ماسح الأسرار في التغييرات الخاصة بالوثائق فقط.

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

كل ما يتلقاه النموذج يُحتسب ضمن حد السياق:

- مطالبة النظام (كل الأقسام المذكورة أعلاه)
- سجل المحادثة (رسائل المستخدم + المساعد)
- استدعاءات الأدوات ونتائج الأدوات
- المرفقات/النصوص (صور، صوت، ملفات)
- ملخصات Compaction وآثار التشذيب
- أغلفة المزوّد أو رؤوس الأمان (غير مرئية، لكنها لا تزال تُحتسب)

لبعض الأسطح الثقيلة في وقت التشغيل حدودها الصريحة الخاصة:

- `agents.defaults.contextLimits.memoryGetMaxChars`
- `agents.defaults.contextLimits.memoryGetDefaultLines`
- `agents.defaults.contextLimits.toolResultMaxChars`
- `agents.defaults.contextLimits.postCompactionMaxChars`

توجد التجاوزات لكل وكيل ضمن `agents.list[].contextLimits`. هذه المقابض
مخصصة لمقتطفات وقت التشغيل المحدودة والكتل المحقونة المملوكة لوقت التشغيل.
وهي منفصلة عن حدود التمهيد، وحدود سياق بدء التشغيل، وحدود مطالبة Skills.

`toolResultMaxChars` سقف متقدم (حتى `1000000` حرف). عند عدم تعيينه، يختار OpenClaw
حد نتيجة الأداة الحي من نافذة سياق النموذج الفعالة: `16000` حرف
دون 100 ألف رمز، و`32000` حرف عند 100 ألف+ رمز، و`64000` حرف عند 200 ألف+
رمز، مع بقائه محدودًا بحارس حصة سياق وقت التشغيل.

بالنسبة إلى الصور، يقلّص OpenClaw حمولات صور النصوص/الأدوات قبل استدعاءات المزوّد.
استخدم `agents.defaults.imageMaxDimensionPx` (الافتراضي: `1200`) لضبط ذلك:

- القيم الأقل تقلل عادةً استخدام رموز الرؤية وحجم الحمولة.
- القيم الأعلى تحفظ تفاصيل بصرية أكثر للقطات الشاشة الكثيفة بـ OCR/واجهة المستخدم.

للحصول على تفصيل عملي (لكل ملف محقون، والأدوات، وSkills، وحجم مطالبة النظام)، استخدم `/context list` أو `/context detail`. راجع [السياق](/ar/concepts/context).

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

استخدم هذه في الدردشة:

- `/status` → **بطاقة حالة غنية بالرموز التعبيرية** مع نموذج الجلسة، واستخدام السياق،
  ورموز الإدخال/الإخراج لآخر استجابة، و**التكلفة المقدّرة** عندما يكون التسعير المحلي
  مكوّنًا للنموذج النشط.
- `/usage off|tokens|full` → يضيف **تذييل استخدام لكل استجابة** إلى كل رد.
  - يستمر لكل جلسة (مخزن كـ `responseUsage`).
  - `/usage reset` (الأسماء المستعارة: `inherit`، `clear`، `default`) — يمسح تجاوز الجلسة
    بحيث تعود الجلسة إلى وراثة الإعداد الافتراضي المكوّن.
  - يعرض `/usage tokens` تفاصيل رموز/ذاكرة تخزين مؤقت للدورة.
  - يعرض `/usage full` تفاصيل مضغوطة للنموذج/السياق/التكلفة؛ ولا تظهر التكلفة المقدّرة
    إلا عندما يمتلك OpenClaw بيانات استخدام وصفية وتسعيرًا محليًا للنموذج النشط.
    يمكن لتخطيطات `messages.usageTemplate` المخصصة تضمين حقول الرموز/ذاكرة التخزين المؤقت.
- `/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` أو ملخصات الجلسة.
يُطبّع استخدام Gemini CLI أيضًا: يقرأ محلل `stream-json` الافتراضي أحداث
`message` الخاصة بالمساعد، ويُعيّن `stats.cached` إلى `cacheRead` مع استخدام
`stats.input_tokens - stats.cached` عندما يحذف CLI حقل `stats.input` الصريح.
لا تزال تجاوزات JSON القديمة تقرأ نص الرد من `response`.
بالنسبة إلى حركة Responses الأصلية من عائلة OpenAI، تُطبّع أسماء استخدام
WebSocket/SSE المستعارة بالطريقة نفسها، وتعود الإجماليات إلى الإدخال + الإخراج
المطبّعين عندما يكون `total_tokens` مفقودًا أو `0`.
عندما تكون لقطة الجلسة الحالية متفرقة، يمكن لـ `/status` و`session_status`
أيضًا استرداد عدادات الرموز/ذاكرة التخزين المؤقت وتسمية نموذج وقت التشغيل النشط من
أحدث سجل استخدام للنص. لا تزال القيم الحية غير الصفرية الحالية لها
الأسبقية على قيم الرجوع من النص، ويمكن للإجماليات النصية الأكبر الموجهة للمطالبة
أن تفوز عندما تكون الإجماليات المخزنة مفقودة أو أصغر.
تأتي مصادقة الاستخدام لنوافذ حصة المزوّد من خطافات خاصة بالمزوّد عندما تكون
متاحة؛ وإلا يعود OpenClaw إلى مطابقة بيانات اعتماد OAuth/API-key
من ملفات تعريف المصادقة، أو البيئة، أو الإعداد.
تستمر إدخالات نصوص المساعد في شكل الاستخدام المطبّع نفسه، بما في ذلك
`usage.cost` عندما يكون للنموذج النشط تسعير مكوّن ويعيد المزوّد
بيانات استخدام وصفية. يمنح هذا `/usage cost` وحالة الجلسة المدعومة بالنصوص
مصدرًا ثابتًا حتى بعد زوال حالة وقت التشغيل الحية.

يبقي OpenClaw محاسبة استخدام المزوّد منفصلة عن لقطة السياق الحالية.
يمكن أن يتضمن `usage.total` للمزوّد إدخالًا مخزنًا مؤقتًا، وإخراجًا، واستدعاءات
نموذج متعددة لحلقة الأدوات، لذا فهو مفيد للتكلفة والقياسات لكنه قد يبالغ في
نافذة السياق الحية. تستخدم عروض السياق والتشخيصات أحدث لقطة مطالبة
(`promptTokens`، أو آخر استدعاء نموذج عندما لا تتوفر لقطة مطالبة)
لـ `context.used`.

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

تُقدّر التكاليف من إعداد تسعير نموذجك:

```
models.providers.<provider>.models[].cost
```

هذه **دولارات أمريكية لكل 1M رمز** لـ `input`، و`output`، و`cacheRead`، و
`cacheWrite`. إذا كان التسعير مفقودًا، يحذف `/usage full` التكلفة؛ استخدم `/usage tokens`
أو `messages.usageTemplate` مخصصًا عندما تحتاج إلى تفاصيل الرموز/ذاكرة التخزين المؤقت في كل
رد. لا يقتصر عرض التكلفة على مصادقة API-key: يمكن للمزوّدين غير المعتمدين على API-key
مثل `aws-sdk` عرض تكلفة مقدّرة عندما يتضمن إدخال النموذج المكوّن لديهم
تسعيرًا محليًا ويعيد المزوّد بيانات استخدام وصفية.

بعد أن تصل العمليات الجانبية والقنوات إلى مسار جاهزية Gateway، يبدأ OpenClaw
تمهيد تسعير اختياريًا في الخلفية لمراجع النماذج المكوّنة التي لا تمتلك
تسعيرًا محليًا بالفعل. يجلب ذلك التمهيد كتالوجات تسعير OpenRouter وLiteLLM
البعيدة. عيّن `models.pricing.enabled: false` لتخطي جلب تلك الكتالوجات
على الشبكات غير المتصلة أو المقيدة؛ وتستمر إدخالات
`models.providers.*.models[].cost` الصريحة في قيادة تقديرات التكلفة المحلية.

## أثر TTL لذاكرة التخزين المؤقت والتشذيب

ينطبق تخزين مطالبات المزوّد مؤقتًا فقط ضمن نافذة TTL لذاكرة التخزين المؤقت. يمكن لـ OpenClaw
تشغيل **تشذيب cache-ttl** اختياريًا: إذ يشذب الجلسة بمجرد انتهاء TTL لذاكرة التخزين المؤقت،
ثم يعيد ضبط نافذة التخزين المؤقت بحيث يمكن للطلبات اللاحقة إعادة استخدام السياق
المخزن مؤقتًا حديثًا بدلًا من إعادة تخزين السجل الكامل مؤقتًا. هذا يبقي تكاليف
كتابة ذاكرة التخزين المؤقت أقل عندما تصبح الجلسة خاملة بعد TTL.

اضبطه في [تكوين Gateway](/ar/gateway/configuration) وراجع
تفاصيل السلوك في [تشذيب الجلسات](/ar/concepts/session-pruning).

يمكن لـ Heartbeat إبقاء ذاكرة التخزين المؤقت **دافئة** عبر فجوات الخمول. إذا كانت TTL لذاكرة
التخزين المؤقت الخاصة بنموذجك `1h`، فإن ضبط فاصل Heartbeat دون ذلك بقليل (مثلًا `55m`) يمكن أن يتجنب
إعادة تخزين المطالبة الكاملة مؤقتًا، مما يقلل تكاليف كتابة ذاكرة التخزين المؤقت.

في إعدادات متعددة الوكلاء، يمكنك الاحتفاظ بتكوين نموذج مشترك واحد وضبط سلوك التخزين المؤقت
لكل وكيل باستخدام `agents.list[].params.cacheRetention`.

للحصول على دليل كامل لكل مقبض على حدة، راجع [تخزين المطالبات مؤقتًا](/ar/reference/prompt-caching).

بالنسبة إلى تسعير Anthropic API، تكون قراءات ذاكرة التخزين المؤقت أرخص بكثير من رموز الإدخال،
بينما تُفوتر كتابات ذاكرة التخزين المؤقت بمعامل أعلى. راجع تسعير تخزين المطالبات مؤقتًا لدى Anthropic
لأحدث الأسعار ومعاملات TTL:
[https://docs.anthropic.com/docs/build-with-claude/prompt-caching](https://docs.anthropic.com/docs/build-with-claude/prompt-caching)

### مثال: إبقاء ذاكرة تخزين مؤقت لمدة ساعة واحدة دافئة باستخدام Heartbeat

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

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

```yaml
agents:
  defaults:
    model:
      primary: "anthropic/claude-opus-4-6"
    models:
      "anthropic/claude-opus-4-6":
        params:
          cacheRetention: "long" # default baseline for most agents
  list:
    - id: "research"
      default: true
      heartbeat:
        every: "55m" # keep long cache warm for deep sessions
    - id: "alerts"
      params:
        cacheRetention: "none" # avoid cache writes for bursty notifications
```

تندمج `agents.list[].params` فوق `params` الخاصة بالنموذج المحدد، بحيث يمكنك
تجاوز `cacheRetention` فقط ووراثة افتراضيات النموذج الأخرى دون تغيير.

### سياق Anthropic 1M

يضبط OpenClaw حجم نماذج Claude 4.x القادرة على GA مثل Opus 4.8 وOpus 4.7 وOpus 4.6 و
Sonnet 4.6 باستخدام نافذة سياق Anthropic بحجم 1M. لا تحتاج إلى
`params.context1m: true` لهذه النماذج.

```yaml
agents:
  defaults:
    models:
      "anthropic/claude-opus-4-6":
        alias: opus
```

يمكن للإعدادات الأقدم الاحتفاظ بـ `context1m: true`، لكن OpenClaw لم يعد يرسل
رأس بيتا المتقاعد `context-1m-2025-08-07` الخاص بـ Anthropic لهذا الإعداد ولا
يوسّع نماذج Claude الأقدم غير المدعومة إلى 1M.

المتطلب: يجب أن تكون بيانات الاعتماد مؤهلة لاستخدام السياق الطويل. إذا لم تكن كذلك،
تستجيب Anthropic بخطأ حد معدل من جانب المزوّد لذلك الطلب.

إذا صادقت Anthropic باستخدام رموز OAuth/الاشتراك (`sk-ant-oat-*`)،
يحافظ OpenClaw على رؤوس بيتا المطلوبة من OAuth لدى Anthropic مع تجريد
بيتا `context-1m-*` المتقاعدة إذا بقيت في إعداد أقدم.

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

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

راجع [Skills](/ar/tools/skills) لمعرفة صيغة الحمل الإضافي الدقيقة لقائمة Skills.

## ذات صلة

- [استخدام API والتكاليف](/ar/reference/api-usage-costs)
- [تخزين الموجّهات مؤقتًا](/ar/reference/prompt-caching)
- [تتبّع الاستخدام](/ar/concepts/usage-tracking)