---
read_when:
    - تحرير نص مطالبة النظام، أو قائمة الأدوات، أو أقسام الوقت/Heartbeat
    - تغيير سلوك bootstrap الخاص بمساحة العمل أو حقن Skills
summary: ما الذي تحتويه مطالبة نظام OpenClaw وكيف يتم تجميعها
title: مطالبة النظام
x-i18n:
    generated_at: "2026-04-21T07:19:25Z"
    model: gpt-5.4
    provider: openai
    source_hash: bc7b887865830e29bcbfb7f88a12fe04f490eec64cb745fc4534051b63a862dc
    source_path: concepts/system-prompt.md
    workflow: 15
---

# مطالبة النظام

يبني OpenClaw مطالبة نظام مخصصة لكل تشغيل وكيل. المطالبة **مملوكة لـ OpenClaw** ولا تستخدم المطالبة الافتراضية الخاصة بـ pi-coding-agent.

يتم تجميع المطالبة بواسطة OpenClaw وحقنها في كل تشغيل وكيل.

يمكن لـ plugins الخاصة بالموفرين أن تسهم بإرشادات مطالبة تراعي التخزين المؤقت من دون استبدال
مطالبة OpenClaw الكاملة المملوكة. ويمكن لبيئة تشغيل الموفر أن:

- تستبدل مجموعة صغيرة من الأقسام الأساسية المسماة (`interaction_style`،
  `tool_call_style`، `execution_bias`)
- تحقن **بادئة مستقرة** فوق حد التخزين المؤقت للمطالبة
- تحقن **لاحقة ديناميكية** أسفل حد التخزين المؤقت للمطالبة

استخدم الإسهامات المملوكة للموفر لضبط السلوك الخاص بعائلة النموذج. وأبقِ تعديل
المطالبة القديم `before_prompt_build` للتوافق أو لتغييرات المطالبة العامة فعلًا، وليس
لسلوك الموفر العادي.

يحافظ تراكب OpenAI GPT-5 family على صِغر قاعدة التنفيذ الأساسية ويضيف
إرشادات خاصة بالنموذج لالتقاط الشخصية، والإخراج الموجز، والانضباط في استخدام الأدوات،
والبحث المتوازي، وتغطية المخرجات، والتحقق، والسياق المفقود، ونظافة
أدوات الطرفية.

## البنية

المطالبة مضغوطة عمدًا وتستخدم أقسامًا ثابتة:

- **الأدوات**: تذكير بالمصدر المرجعي المنظم للأدوات بالإضافة إلى إرشادات استخدام الأدوات وقت التشغيل.
- **نزعة التنفيذ**: إرشادات متابعة موجزة: التصرف ضمن الدور في
  الطلبات القابلة للتنفيذ، والمتابعة حتى الاكتمال أو التعذر، والتعافي من نتائج الأدوات
  الضعيفة، والتحقق من الحالة القابلة للتغيير مباشرة، والتحقق قبل الإنهاء.
- **السلامة**: تذكير موجز بالحواجز الوقائية لتجنب السلوك الساعي إلى القوة أو تجاوز الإشراف.
- **Skills** (عند توفرها): يخبر النموذج بكيفية تحميل تعليمات المهارة عند الطلب.
- **التحديث الذاتي لـ OpenClaw**: كيفية فحص الإعدادات بأمان باستخدام
  `config.schema.lookup`، وتصحيح الإعدادات باستخدام `config.patch`، واستبدال
  الإعدادات بالكامل باستخدام `config.apply`، وتشغيل `update.run` فقط عند طلب
  صريح من المستخدم. كما أن أداة `gateway` المحصورة بالمالك ترفض أيضًا إعادة كتابة
  `tools.exec.ask` / `tools.exec.security`، بما في ذلك الأسماء المستعارة القديمة `tools.bash.*`
  التي يتم تطبيعها إلى مسارات exec المحمية تلك.
- **مساحة العمل**: دليل العمل (`agents.defaults.workspace`).
- **التوثيق**: المسار المحلي إلى وثائق OpenClaw (المستودع أو حزمة npm) ووقت قراءتها.
- **ملفات مساحة العمل (المحقونة)**: تشير إلى أن ملفات bootstrap مضمنة أدناه.
- **Sandbox** (عند التفعيل): يشير إلى بيئة تشغيل معزولة، ومسارات sandbox، وما إذا كان exec المرتفع الصلاحيات متاحًا.
- **التاريخ والوقت الحاليان**: التوقيت المحلي للمستخدم، والمنطقة الزمنية، وتنسيق الوقت.
- **وسوم الرد**: صيغة وسوم رد اختيارية للموفرين المدعومين.
- **Heartbeats**: مطالبة Heartbeat وسلوك الإقرار، عندما تكون Heartbeats مفعلة للوكيل الافتراضي.
- **وقت التشغيل**: المضيف، ونظام التشغيل، وnode، والنموذج، وجذر المستودع (عند اكتشافه)، ومستوى التفكير (سطر واحد).
- **الاستدلال**: مستوى الرؤية الحالي + تلميح تبديل /reasoning.

يتضمن قسم الأدوات أيضًا إرشادات وقت التشغيل للأعمال طويلة التنفيذ:

- استخدم Cron للمتابعة المستقبلية (`check back later`، والتذكيرات، والأعمال المتكررة)
  بدلًا من حلقات النوم في `exec`، أو حيل التأخير `yieldMs`، أو الاستقصاء المتكرر لـ `process`
- استخدم `exec` / `process` فقط للأوامر التي تبدأ الآن وتستمر في العمل
  في الخلفية
- عند تفعيل الإيقاظ التلقائي عند الاكتمال، ابدأ الأمر مرة واحدة واعتمد على
  مسار الإيقاظ المعتمد على الدفع عندما يصدر مخرجات أو يفشل
- استخدم `process` للسجلات، أو الحالة، أو الإدخال، أو التدخل عندما تحتاج إلى
  فحص أمر قيد التشغيل
- إذا كانت المهمة أكبر، ففضّل `sessions_spawn`؛ إذ إن اكتمال الوكيل الفرعي يعتمد على
  الدفع ويُعلن تلقائيًا مرة أخرى إلى الطالب
- لا تستطلع `subagents list` / `sessions_list` في حلقة فقط بانتظار
  الاكتمال

عند تفعيل الأداة التجريبية `update_plan`، يخبر قسم الأدوات النموذج أيضًا
باستخدامها فقط في الأعمال غير البسيطة متعددة الخطوات، والإبقاء على خطوة واحدة فقط
بحالة `in_progress`، وتجنب تكرار الخطة كاملة بعد كل تحديث.

حواجز السلامة في مطالبة النظام استرشادية. فهي توجه سلوك النموذج لكنها لا تفرض سياسة. استخدم سياسة الأدوات، وموافقات exec، وsandboxing، وقوائم السماح للقنوات لفرض التنفيذ الصارم؛ ويمكن للمشغلين تعطيل هذه الأمور عمدًا.

في القنوات التي تحتوي على بطاقات/أزرار موافقة أصلية، تخبر مطالبة وقت التشغيل الآن
الوكيل بالاعتماد أولًا على واجهة الموافقة الأصلية تلك. ويجب عليه ألا يضمّن أمرًا يدويًا
`/approve` إلا عندما تشير نتيجة الأداة إلى أن موافقات الدردشة غير متاحة أو أن
الموافقة اليدوية هي المسار الوحيد.

## أوضاع المطالبة

يمكن لـ OpenClaw عرض مطالبات نظام أصغر للوكلاء الفرعيين. تضبط بيئة التشغيل
`promptMode` لكل تشغيل (وليس إعدادًا ظاهرًا للمستخدم):

- `full` (الافتراضي): يتضمن جميع الأقسام أعلاه.
- `minimal`: يُستخدم للوكلاء الفرعيين؛ ويحذف **Skills** و**استرجاع الذاكرة** و**التحديث الذاتي لـ OpenClaw** و**الأسماء المستعارة للنماذج** و**هوية المستخدم** و**وسوم الرد** و**المراسلة** و**الردود الصامتة** و**Heartbeats**. وتظل الأدوات و**السلامة** ومساحة العمل وSandbox والتاريخ والوقت الحاليان (عند معرفتهما) ووقت التشغيل والسياق المحقون متاحة.
- `none`: يعيد فقط سطر الهوية الأساسي.

عندما تكون قيمة `promptMode=minimal`، يتم تصنيف المطالبات الإضافية المحقونة باسم **سياق الوكيل الفرعي**
بدلًا من **سياق الدردشة الجماعية**.

## حقن bootstrap الخاص بمساحة العمل

يتم تقليم ملفات bootstrap وإلحاقها تحت **سياق المشروع** حتى يرى النموذج سياق الهوية والملف الشخصي من دون الحاجة إلى قراءات صريحة:

- `AGENTS.md`
- `SOUL.md`
- `TOOLS.md`
- `IDENTITY.md`
- `USER.md`
- `HEARTBEAT.md`
- `BOOTSTRAP.md` (فقط في مساحات العمل الجديدة تمامًا)
- `MEMORY.md` عند وجوده، وإلا `memory.md` كبديل بأحرف صغيرة

كل هذه الملفات **تُحقن في نافذة السياق** في كل دورة ما لم
تنطبق بوابة خاصة بالملف. ويتم حذف `HEARTBEAT.md` في التشغيلات العادية عندما
تكون Heartbeats معطلة للوكيل الافتراضي أو عندما تكون
`agents.defaults.heartbeat.includeSystemPromptSection` مساوية لـ false. أبقِ الملفات
المحقونة موجزة — خصوصًا `MEMORY.md` الذي يمكن أن ينمو مع الوقت ويؤدي إلى
استخدام سياق أعلى من المتوقع وCompaction أكثر تكرارًا.

> **ملاحظة:** ملفات `memory/*.md` اليومية **ليست** جزءًا من bootstrap
> المعتاد لسياق المشروع. ففي الدورات العادية يتم الوصول إليها عند الطلب عبر
> الأداتين `memory_search` و`memory_get`، لذلك لا تُحتسب ضمن
> نافذة السياق إلا إذا قرأها النموذج صراحة. وتُعد دورات `/new` و`/reset`
> المجردة هي الاستثناء: إذ يمكن لبيئة التشغيل أن تسبق
> الذاكرة اليومية الحديثة ككتلة سياق بدء لمرة واحدة لذلك الدور الأول.

تُقتطع الملفات الكبيرة مع وسم. ويُتحكم في الحد الأقصى لحجم كل ملف عبر
`agents.defaults.bootstrapMaxChars` (الافتراضي: 12000). كما أن إجمالي محتوى bootstrap
المحقون عبر الملفات مقيّد بواسطة `agents.defaults.bootstrapTotalMaxChars`
(الافتراضي: 60000). وتحقن الملفات المفقودة وسمًا قصيرًا للملف المفقود. وعندما يحدث الاقتطاع،
يمكن لـ OpenClaw حقن كتلة تحذير في سياق المشروع؛ ويُتحكم في ذلك عبر
`agents.defaults.bootstrapPromptTruncationWarning` (`off` أو `once` أو `always`؛
الافتراضي: `once`).

جلسات الوكلاء الفرعيين لا تحقن إلا `AGENTS.md` و`TOOLS.md` (وتُستبعد ملفات bootstrap الأخرى
لإبقاء سياق الوكيل الفرعي صغيرًا).

يمكن للخطافات الداخلية اعتراض هذه الخطوة عبر `agent:bootstrap` لتعديل أو استبدال
ملفات bootstrap المحقونة (على سبيل المثال استبدال `SOUL.md` بشخصية بديلة).

إذا كنت تريد أن تجعل الوكيل يبدو أقل عمومية، فابدأ من
[دليل شخصية SOUL.md](/ar/concepts/soul).

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

## التعامل مع الوقت

تتضمن مطالبة النظام قسم **التاريخ والوقت الحاليان** مخصصًا عندما تكون
المنطقة الزمنية للمستخدم معروفة. وللحفاظ على ثبات التخزين المؤقت للمطالبة، فهي الآن تتضمن فقط
**المنطقة الزمنية** (من دون ساعة ديناميكية أو تنسيق وقت).

استخدم `session_status` عندما يحتاج الوكيل إلى الوقت الحالي؛ إذ تتضمن
بطاقة الحالة سطر طابع زمني. ويمكن للأداة نفسها أيضًا تعيين تجاوز نموذج لكل جلسة
اختياريًا (`model=default` يمسح هذا التجاوز).

اضبط ذلك باستخدام:

- `agents.defaults.userTimezone`
- `agents.defaults.timeFormat` (`auto` | `12` | `24`)

راجع [التاريخ والوقت](/ar/date-time) للحصول على تفاصيل السلوك الكاملة.

## Skills

عند وجود Skills مؤهلة، يحقن OpenClaw **قائمة Skills متاحة** مضغوطة
(`formatSkillsForPrompt`) تتضمن **مسار الملف** لكل Skill. وتوجّه
المطالبة النموذج لاستخدام `read` لتحميل ملف SKILL.md من الموقع المدرج
(مساحة العمل، أو المُدار، أو المضمن). وإذا لم تكن هناك Skills مؤهلة، يتم حذف قسم
Skills.

تشمل الأهلية بوابات البيانات الوصفية للمهارة، وفحوصات البيئة/الإعدادات وقت التشغيل،
وقائمة السماح الفعالة للمهارات للوكيل عندما يتم ضبط `agents.defaults.skills` أو
`agents.list[].skills`.

```
<available_skills>
  <skill>
    <name>...</name>
    <description>...</description>
    <location>...</location>
  </skill>
</available_skills>
```

يبقي هذا المطالبة الأساسية صغيرة مع الاستمرار في تمكين استخدام Skills مستهدف.

تعود ملكية ميزانية قائمة Skills إلى النظام الفرعي للمهارات:

- الافتراضي العام: `skills.limits.maxSkillsPromptChars`
- تجاوز لكل وكيل: `agents.list[].skillsLimits.maxSkillsPromptChars`

تستخدم المقاطع العامة المحدودة لوقت التشغيل سطحًا مختلفًا:

- `agents.defaults.contextLimits.*`
- `agents.list[].contextLimits.*`

يبقي هذا الفصل حجم Skills منفصلًا عن أحجام القراءة/الحقن وقت التشغيل مثل
`memory_get`، ونتائج الأدوات الحية، وتحديثات AGENTS.md بعد Compaction.

## التوثيق

عند توفره، تتضمن مطالبة النظام قسم **التوثيق** يشير إلى
دليل وثائق OpenClaw المحلي (إما `docs/` في مساحة عمل المستودع أو وثائق حزمة npm
المضمنة) ويذكر أيضًا المرآة العامة، والمستودع المصدر، وDiscord الخاص بالمجتمع،
وClawHub ([https://clawhub.ai](https://clawhub.ai)) لاكتشاف Skills. وتوجّه المطالبة النموذج إلى الرجوع أولًا إلى الوثائق المحلية
لسلوك OpenClaw، أو الأوامر، أو الإعدادات، أو البنية، وإلى تشغيل
`openclaw status` بنفسه عندما يكون ذلك ممكنًا (ولا يطلب من المستخدم إلا عندما يفتقر إلى الوصول).
