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

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

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

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

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

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

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

## البنية

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

- **الأدوات**: تذكير منظَّم بمصدر الحقيقة للأدوات المهيكلة مع إرشادات استخدام الأدوات أثناء وقت التشغيل.
- **السلامة**: تذكير مختصر بالضوابط الوقائية لتجنب السلوك الساعي إلى السلطة أو تجاوز الإشراف.
- **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) ومتى يجب قراءتها.
- **ملفات مساحة العمل (محقونة)**: تشير إلى أن ملفات التهيئة الأولية مضمنة أدناه.
- **Sandbox** (عند التمكين): يوضح بيئة التشغيل المعزولة، ومسارات Sandbox، وما إذا كان التنفيذ المرفوع الصلاحيات متاحًا.
- **التاريخ والوقت الحاليان**: الوقت المحلي للمستخدم، والمنطقة الزمنية، وتنسيق الوقت.
- **وسوم الرد**: صياغة وسوم الرد الاختيارية للموفرين المدعومين.
- **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، وSandbox، وقوائم السماح الخاصة بالقنوات لفرض التنفيذ الصارم؛ ويمكن للمشغلين تعطيل هذه الأمور عمدًا.

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

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

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

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

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

## حقن التهيئة الأولية لمساحة العمل

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

- `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` اليومية **ليست** جزءًا من
> **سياق المشروع** العادي الخاص بالتهيئة الأولية. في الدورات العادية، يُصل إليها
> عند الطلب عبر أداتي `memory_search` و`memory_get`، لذلك لا تُحتسب ضمن
> نافذة السياق إلا إذا قرأها النموذج صراحة. أما دورات `/new` و`/reset` المجردة
> فهي الاستثناء: إذ يمكن لوقت التشغيل أن يضيف مقدمًا ذاكرة يومية حديثة
> ككتلة سياق بدء لمرة واحدة لتلك الدورة الأولى.

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

لا تحقن جلسات الوكيل الفرعي سوى `AGENTS.md` و`TOOLS.md` (تُرشَّح بقية ملفات التهيئة الأولية
للحفاظ على صغر سياق الوكيل الفرعي).

يمكن للخطافات الداخلية اعتراض هذه الخطوة عبر `agent: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.

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

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

يحافظ ذلك على صغر المطالبة الأساسية مع الاستمرار في تمكين استخدام 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` بنفسه متى أمكن (وسؤال المستخدم فقط عندما يفتقر إلى إمكانية الوصول).
