الأساسيات

موجه النظام

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

الهيكل

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

  • الأدوات: قائمة الأدوات الحالية + أوصاف مختصرة.
  • السلامة: تذكير قصير بقيود السلامة لتجنب السلوك الساعي للسلطة أو تجاوز الرقابة.
  • المهارات (عند التوفر): يخبر النموذج بكيفية تحميل تعليمات المهارات عند الطلب.
  • التحديث الذاتي لـ OpenClaw: كيفية تشغيل config.apply و update.run.
  • مساحة العمل: دليل العمل الحالي (agents.defaults.workspace).
  • التوثيق: المسار المحلي لوثائق OpenClaw (مستودع أو حزمة npm) ومتى تقرأها.
  • ملفات مساحة العمل (محقونة): يشير إلى تضمين ملفات التهيئة أدناه.
  • البيئة المعزولة (عند التمكين): يشير إلى وقت التشغيل المعزول، مسارات البيئة المعزولة، وما إذا كان exec المرفوع متاحًا.
  • التاريخ والوقت الحاليان: وقت المستخدم المحلي، النطاق الزمني، وتنسيق الوقت.
  • وسوم الرد: بناء جملة وسوم الرد الاختيارية لمزودي الخدمة المدعومين.
  • نبضات القلب: موجه نبضات القلب وسلوك التأكيد.
  • وقت التشغيل: المضيف، نظام التشغيل، node، النموذج، جذر المستودع (عند الكشف)، مستوى التفكير (سطر واحد).
  • التفكير: مستوى الرؤية الحالي + تلميح تبديل /reasoning.

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

أوضاع الموجه

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

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

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

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

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

  • AGENTS.md
  • SOUL.md
  • TOOLS.md
  • IDENTITY.md
  • USER.md
  • HEARTBEAT.md
  • BOOTSTRAP.md (فقط في مساحات العمل الجديدة تمامًا)
  • MEMORY.md و/أو memory.md (عند وجودها في مساحة العمل؛ قد يتم حقن أحدهما أو كليهما)

يتم حقن جميع هذه الملفات في نافذة السياق في كل دورة، مما يعني أنها تستهلك رموزًا. حافظ على إيجازها — خاصةً MEMORY.md، التي يمكن أن تنمو بمرور الوقت وتؤدي إلى استخدام سياق مرتفع بشكل غير متوقع وضغط أكثر تكرارًا.

ملاحظة: ملفات memory/*.md اليومية لا تُحقن تلقائيًا. يتم الوصول إليها عند الطلب عبر أدوات memory_search و memory_get، لذلك لا تحتسب ضد نافذة السياق إلا إذا قرأها النموذج صراحةً.

يتم اقتطاع الملفات الكبيرة بواسطة علامة. يتم التحكم بالحجم الأقصى لكل ملف بواسطة agents.defaults.bootstrapMaxChars (الافتراضي: 20000). إجمالي محتوى التهيئة المحقون عبر الملفات محدود بـ agents.defaults.bootstrapTotalMaxChars (الافتراضي: 150000). تحقن الملفات المفقودة علامة ملف مفقود قصيرة. عند حدوث اقتطاع، يمكن لـ OpenClaw حقن كتلة تحذير في سياق المشروع؛ تحكم في هذا بـ agents.defaults.bootstrapPromptTruncationWarning (off, once, always; الافتراضي: once). تحقن جلسات الوكلاء الفرعيين فقط AGENTS.md و TOOLS.md (يتم تصفية ملفات التهيئة الأخرى للحفاظ على سياق الوكيل الفرعي صغيرًا). يمكن للخطافات الداخلية اعتراض هذه الخطوة عبر agent:bootstrap لتعديل أو استبدال ملفات التهيئة المحقونة (على سبيل المثال، استبدال SOUL.md بشخصية بديلة). لفحص مقدار مساهمة كل ملف محقون (خام مقابل محقون، اقتطاع، بالإضافة إلى حمل مخطط الأداة)، استخدم /context list أو /context detail. راجع السياق.

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

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

  • agents.defaults.userTimezone
  • agents.defaults.timeFormat (auto | 12 | 24)

راجع التاريخ والوقت للحصول على تفاصيل السلوك الكاملة.

المهارات

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

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

هذا يحافظ على صغر الموجه الأساسي مع تمكين استخدام المهارات المستهدفة.

التوثيق

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

حلقة الوكيلالسياق