---
read_when:
    - تحرير نص موجّه النظام، أو قائمة الأدوات، أو أقسام الوقت/Heartbeat
    - تغيير سلوك تمهيد مساحة العمل أو حقن Skills
summary: ما يحتويه موجّه نظام OpenClaw وكيفية تجميعه
title: موجّه النظام
x-i18n:
    generated_at: "2026-05-02T23:39:15Z"
    model: gpt-5.5
    provider: openai
    source_hash: f8e0234453812c16cf5d273096d335049bf435ca76ade36200caf4bb344624e5
    source_path: concepts/system-prompt.md
    workflow: 16
---

ينشئ OpenClaw موجّه نظام مخصصًا لكل تشغيل وكيل. الموجّه **مملوك لـ OpenClaw** ولا يستخدم موجّه pi-coding-agent الافتراضي.

يجمّع OpenClaw الموجّه ويحقنه في كل تشغيل وكيل.

يمكن لـ Plugins المزوّد أن تساهم بإرشادات موجّه واعية بذاكرة التخزين المؤقت دون استبدال
الموجّه الكامل المملوك لـ OpenClaw. يمكن لوقت تشغيل المزوّد أن:

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

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

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

## البنية

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

- **الأدوات**: تذكير بمصدر الحقيقة للأداة المنظمة مع إرشادات وقت التشغيل لاستخدام الأدوات.
- **انحياز التنفيذ**: إرشادات متابعة مضغوطة: التصرف ضمن الدور عند
  الطلبات القابلة للتنفيذ، والاستمرار حتى الاكتمال أو التعطل، والتعافي من نتائج الأدوات
  الضعيفة، وفحص الحالة القابلة للتغيير مباشرة، والتحقق قبل الإنهاء.
- **السلامة**: تذكير قصير بضوابط الحماية لتجنب سلوك السعي إلى السلطة أو تجاوز الإشراف.
- **Skills** (عند توفرها): يخبر النموذج بكيفية تحميل تعليمات 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، ومسارات sandbox، وما إذا كان تنفيذ exec المرتفع متاحًا.
- **التاريخ والوقت الحاليان**: وقت المستخدم المحلي، والمنطقة الزمنية، وتنسيق الوقت.
- **وسوم الرد**: صيغة اختيارية لوسوم الرد للمزوّدين المدعومين.
- **Heartbeats**: موجّه Heartbeat وسلوك الإقرار، عند تمكين Heartbeats للوكيل الافتراضي.
- **وقت التشغيل**: المضيف، ونظام التشغيل، وnode، والنموذج، وجذر المستودع (عند اكتشافه)، ومستوى التفكير (سطر واحد).
- **الاستدلال**: مستوى الظهور الحالي + تلميح تبديل /reasoning.

يبقي OpenClaw المحتوى المستقر الكبير، بما في ذلك **سياق المشروع**، أعلى
حد ذاكرة تخزين الموجّه المؤقتة الداخلي. وتُضاف أقسام القناة/الجلسة المتغيرة مثل
إرشادات تضمين Control UI، و**المراسلة**، و**الصوت**، و**سياق دردشة المجموعة**،
و**التفاعلات**، و**Heartbeats**، و**وقت التشغيل** أسفل ذلك الحد
كي تتمكن الخلفيات المحلية ذات ذاكرات تخزين البادئة المؤقتة من إعادة استخدام بادئة مساحة العمل المستقرة
عبر أدوار القناة. وبالمثل، ينبغي أن تتجنب أوصاف الأدوات تضمين أسماء القنوات الحالية
عندما يحمل المخطط المقبول هذه التفاصيل الخاصة بوقت التشغيل بالفعل.

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

- استخدم 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**، و**Memory Recall**، و**التحديث الذاتي لـ OpenClaw
  Self-Update**، و**الأسماء المستعارة للنماذج**، و**هوية المستخدم**، و**وسوم الرد**،
  و**المراسلة**، و**الردود الصامتة**، و**Heartbeats**. تظل الأدوات، و**السلامة**،
  ومساحة العمل، وSandbox، والتاريخ والوقت الحاليان (عند معرفتهما)، ووقت التشغيل، والسياق المحقون
  متاحة.
- `none`: يعيد فقط سطر الهوية الأساسي.

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

بالنسبة إلى تشغيلات الرد التلقائي للقنوات، يمكن لـ OpenClaw حذف قسم **الردود الصامتة**
العام عندما يتضمن سياق الدردشة المباشرة/المجموعة بالفعل سلوك
`NO_REPLY` الخاص بالمحادثة والمحلول. يتجنب ذلك تكرار آليات الرموز
في كل من موجّه النظام العام وسياق القناة.

## لقطات الموجّه

يحتفظ OpenClaw بلقطات موجّه ملتزم بها لمسار Codex runtime السعيد ضمن
`test/fixtures/agents/prompt-snapshots/codex-runtime-happy-path/`. تعرض هذه اللقطات
معلمات خيط/دور مختارة من خادم التطبيق إضافة إلى مكدس طبقات موجّه مرتبط بالنموذج ومُعاد بناؤه
لأدوار Telegram المباشرة، ومجموعة Discord، وHeartbeat. يتضمن ذلك المكدس
مثبتًا لموجّه نموذج Codex `gpt-5.5` مولدًا من شكل كتالوج/ذاكرة تخزين نماذج Codex،
ونص مطوّر الأذونات لمسار Codex السعيد،
وتعليمات مطوّر OpenClaw، ومدخل دور المستخدم، وإشارات إلى مواصفات الأدوات الديناميكية.

حدّث مثبت موجّه نموذج Codex باستخدام
`pnpm prompt:snapshots:sync-codex-model`. افتراضيًا، يبحث النص البرمجي عن
ذاكرة تخزين وقت تشغيل Codex في `$CODEX_HOME/models_cache.json`، ثم
`~/.codex/models_cache.json`، ثم يعود فقط إلى عرف checkout الخاص بمشرف Codex
في `~/code/codex/codex-rs/models-manager/models.json`. إذا لم توجد
أي من هذه المصادر، ينهي الأمر دون تغيير المثبت الملتزم به.
مرر `--catalog <path>` للتحديث من ملف `models_cache.json`
أو `models.json` محدد.

هذه اللقطات ما زالت ليست التقاطًا أوليًا حرفيًا لطلب OpenAI. يمكن لـ Codex
إضافة سياق مساحة عمل مملوك لوقت التشغيل مثل `AGENTS.md`، وسياق البيئة،
والذكريات، وتعليمات التطبيق/Plugin، وتعليمات أوضاع التعاون المستقبلية
داخل Codex runtime بعد أن يرسل OpenClaw معلمات الخيط والدور.

أعد توليدها باستخدام `pnpm prompt:snapshots:gen` وتحقق من الانحراف باستخدام
`pnpm prompt:snapshots:check`. يشغّل CI فحص الانحراف في شريحة
الحدود الإضافية حتى تبقى تغييرات الموجّه وتحديثات اللقطات مرتبطة بالـ PR نفسه.

## حقن تمهيد مساحة العمل

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

- `AGENTS.md`
- `SOUL.md`
- `TOOLS.md`
- `IDENTITY.md`
- `USER.md`
- `HEARTBEAT.md`
- `BOOTSTRAP.md` (فقط في مساحات العمل الجديدة تمامًا)
- `MEMORY.md` عند وجوده

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

عندما تعمل جلسة على حاضنة Codex الأصلية، يحمّل Codex ملف `AGENTS.md`
من خلال اكتشاف مستندات المشروع الخاص به. لا يزال OpenClaw يحل ملفات
التمهيد المتبقية ويمررها كتعليمات إعدادات Codex، لذا يحافظ `SOUL.md`،
و`TOOLS.md`، و`IDENTITY.md`، و`USER.md`، و`HEARTBEAT.md`، و`BOOTSTRAP.md`، و
`MEMORY.md` على دور سياق مساحة العمل نفسه دون تكرار
`AGENTS.md`.

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

تُقتطع الملفات الكبيرة مع وسم. يتحكم
`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` مضبوطة.

تكون Skills المجمعة ضمن Plugin مؤهلة فقط عندما يكون Plugin المالك لها مفعّلًا.
يتيح ذلك لـ Plugins الأدوات كشف أدلة تشغيل أعمق دون تضمين كل
تلك الإرشادات مباشرة في كل وصف أداة.

```
<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/` في نسخة Git أو وثائق حزمة npm المضمّنة). إذا كانت الوثائق المحلية غير متاحة، فإنه يعود إلى [https://docs.openclaw.ai](https://docs.openclaw.ai).

يتضمن القسم نفسه أيضًا موقع مصدر OpenClaw. تعرض نسخ Git الجذر المحلي للمصدر حتى يتمكن الوكيل من فحص الشيفرة مباشرة. تتضمن عمليات تثبيت الحزمة عنوان URL لمصدر GitHub وتطلب من الوكيل مراجعة المصدر هناك كلما كانت الوثائق غير مكتملة أو قديمة. يشير الموجّه أيضًا إلى مرآة الوثائق العامة، ومجتمع Discord، وClawHub ([https://clawhub.ai](https://clawhub.ai)) لاكتشاف Skills. ويوجه النموذج إلى مراجعة الوثائق أولًا بشأن سلوك OpenClaw أو أوامره أو تكوينه أو بنيته، وإلى تشغيل `openclaw status` بنفسه عند الإمكان (مع سؤال المستخدم فقط عندما لا يملك وصولًا). وبالنسبة إلى التكوين تحديدًا، فإنه يوجّه الوكلاء إلى إجراء أداة `gateway` وهو `config.schema.lookup` للحصول على وثائق وقيود دقيقة على مستوى الحقول، ثم إلى `docs/gateway/configuration.md` و`docs/gateway/configuration-reference.md` للحصول على إرشادات أوسع.

## ذو صلة

- [وقت تشغيل الوكيل](/ar/concepts/agent)
- [مساحة عمل الوكيل](/ar/concepts/agent-workspace)
- [محرك السياق](/ar/concepts/context-engine)
