---
read_when:
    - تعديل نص مطالبة النظام أو قائمة الأدوات أو أقسام الوقت/Heartbeat
    - تغيير سلوك تمهيد مساحة العمل أو حقن Skills
summary: ما الذي يحتوي عليه موجّه نظام OpenClaw وكيف يُجمَّع
title: موجّه النظام
x-i18n:
    generated_at: "2026-05-10T19:36:46Z"
    model: gpt-5.5
    provider: openai
    source_hash: 7aa3db4f53ffe5c11fd85159044344b56cd11c3bdb1a5a5de7638b21fb813135
    source_path: concepts/system-prompt.md
    workflow: 16
---

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

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

يتكون تجميع الموجه من ثلاث طبقات:

- يعرض `buildAgentSystemPrompt` الموجه من مدخلات صريحة. ينبغي أن
  يبقى عارضًا نقيًا وألا يقرأ الإعدادات العامة مباشرة.
- يحل `resolveAgentSystemPromptConfig` مقابض الموجه المدعومة بالإعدادات، مثل
  عرض المالك، وتلميحات TTS، والأسماء المستعارة للنماذج، ووضع اقتباس الذاكرة، ووضع
  تفويض الوكيل الفرعي لوكيل محدد.
- تجمع مهايئات وقت التشغيل (المضمنة، وCLI، ومعاينات الأمر/التصدير، وCompaction)
  الحقائق الحية مثل الأدوات، وحالة العزل، وإمكانات القنوات، وملفات السياق،
  ومساهمات موجه الموفر، ثم تستدعي واجهة الموجه المهيأة.

هذا يبقي أسطح الموجهات المصدرة/التصحيحية متوافقة مع التشغيلات الحية دون
تحويل كل تفصيل خاص بوقت التشغيل إلى بانٍ أحادي ضخم.

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

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

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

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

## البنية

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

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

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

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

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

يمكن لـ `agents.defaults.subagents.delegationMode` تقوية هذه الإرشادات. يبقي
وضع `suggest` الافتراضي التلميح الأساسي. يضيف `prefer` قسمًا مخصصًا
**تفويض الوكيل الفرعي** يخبر الوكيل الرئيسي أن يعمل كمنسق سريع الاستجابة
وأن يدفع أي شيء أكثر تعقيدًا من رد مباشر عبر `sessions_spawn`. هذا متعلق
بالموجه فقط؛ لا تزال سياسة الأدوات تتحكم في ما إذا كان `sessions_spawn` متاحًا.

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

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

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

## أوضاع الموجه

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

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

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

لا تزال هذه اللقطات ليست التقاطًا خامًا لطلب OpenAI مطابقًا بايتًا ببايت. يمكن لـ Codex
إضافة سياق مساحة عمل مملوك لوقت التشغيل مثل `AGENTS.md`، وسياق البيئة،
والذكريات، وتعليمات التطبيق/Plugin، وتعليمات وضع التعاون المضمن Default
داخل وقت تشغيل Codex بعد أن يرسل 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`. صُمم `MEMORY.md`
ليبقى ملخصًا طويل الأمد منسقًا؛ أما الملاحظات اليومية التفصيلية فمكانها
`memory/*.md` حيث يمكن لـ `memory_search` و`memory_get` استرجاعها عند الطلب.
تزيد ملفات `MEMORY.md` الكبيرة استخدام الموجه ويمكن أن تُحقن جزئيًا بسبب
حدود ملفات التمهيد أدناه.

عندما تعمل جلسة على حزمة 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`). تبقى العدادات الخام/المحقونة التفصيلية في التشخيصات مثل
`/context`، و`/status`، وdoctor، والسجلات.

بالنسبة إلى ملفات الذاكرة، لا يعني الاقتطاع فقدان بيانات: يبقى الملف سليمًا على القرص،
لكن النموذج لا يرى إلا النسخة المحقونة المختصرة حتى يقرأ الذاكرة أو يبحث فيها
مباشرة. إذا كان `MEMORY.md` يُقتطع مرارًا، فاختصره إلى ملخص دائم أقصر وانقل
السجل التفصيلي إلى `memory/*.md`، أو ارفع حدود التمهيد عمدًا.

تحقن جلسات الوكلاء الفرعيين `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)