الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

يُشغّل OpenClaw بيئة تشغيل وكيل مضمنة واحدة - عملية وكيل واحدة لكل Gateway، مع مساحة عمل خاصة بها وملفات تمهيد ومخزن جلسات. تغطي هذه الصفحة عقد بيئة التشغيل هذا: ما الذي يجب أن تحتويه مساحة العمل، وأي الملفات تُحقن، وكيف تُمهّد الجلسات اعتمادًا عليها.

​
مساحة العمل (مطلوبة)

يستخدم OpenClaw دليل مساحة عمل وكيل واحدًا (agents.defaults.workspace) بصفته دليل العمل الوحيد (cwd) للوكيل للأدوات والسياق. موصى به: استخدم openclaw setup لإنشاء ~/.openclaw/openclaw.json إذا كان مفقودًا وتهيئة ملفات مساحة العمل. تخطيط مساحة العمل الكامل + دليل النسخ الاحتياطي: مساحة عمل الوكيل إذا كان agents.defaults.sandbox مفعّلًا، فيمكن للجلسات غير الرئيسية تجاوز هذا باستخدام مساحات عمل لكل جلسة ضمن agents.defaults.sandbox.workspaceRoot (راجع تكوين Gateway).

​
ملفات التمهيد (محقونة)

داخل agents.defaults.workspace، يتوقع OpenClaw هذه الملفات القابلة للتحرير من المستخدم:
  • AGENTS.md - تعليمات التشغيل + “الذاكرة”
  • SOUL.md - الشخصية، الحدود، النبرة
  • TOOLS.md - ملاحظات أدوات يديرها المستخدم (مثل imsg وsag والأعراف)
  • BOOTSTRAP.md - طقس تشغيل أولي لمرة واحدة (يُحذف بعد الاكتمال)
  • IDENTITY.md - اسم الوكيل/طابعه/رمزه التعبيري
  • USER.md - ملف تعريف المستخدم + طريقة النداء المفضلة
في أول دور من جلسة جديدة، يحقن OpenClaw محتويات هذه الملفات في سياق المشروع الخاص بموجّه النظام. تُتخطى الملفات الفارغة. تُقصَّر الملفات الكبيرة وتُقتطع مع علامة حتى تبقى الموجّهات خفيفة (اقرأ الملف للاطلاع على المحتوى الكامل). إذا كان ملف مفقودًا، يحقن OpenClaw سطر علامة واحدًا يشير إلى “ملف مفقود” (وسيُنشئ openclaw setup قالبًا افتراضيًا آمنًا). لا يُنشأ BOOTSTRAP.md إلا لمساحة عمل جديدة تمامًا (لا توجد ملفات تمهيد أخرى). أثناء انتظاره، يُبقيه OpenClaw في سياق المشروع ويضيف إرشادات تمهيد إلى موجّه النظام للطقس الأولي بدلًا من نسخه إلى رسالة المستخدم. إذا حذفته بعد إكمال الطقس، فلا ينبغي إعادة إنشائه عند عمليات إعادة التشغيل اللاحقة. لتعطيل إنشاء ملفات التمهيد بالكامل (لمساحات العمل المعبأة مسبقًا)، اضبط: 
{ agents: { defaults: { skipBootstrap: true } } }

​
الأدوات المضمنة

الأدوات الأساسية (القراءة/التنفيذ/التحرير/الكتابة وأدوات النظام ذات الصلة) متاحة دائمًا، خاضعة لسياسة الأدوات. apply_patch اختياري ومحكوم بواسطة tools.exec.applyPatch. لا يتحكم TOOLS.md في الأدوات الموجودة؛ بل هو إرشاد لكيفية رغبتك أنت في استخدامها.

​
Skills

يحمّل OpenClaw Skills من هذه المواقع (الأولوية الأعلى أولًا):
  • مساحة العمل: <workspace>/skills
  • Skills وكيل المشروع: <workspace>/.agents/skills
  • Skills الوكيل الشخصية: ~/.agents/skills
  • المُدارة/المحلية: ~/.openclaw/skills
  • المضمّنة (المشحونة مع التثبيت)
  • مجلدات Skills إضافية: skills.load.extraDirs
يمكن تقييد Skills بواسطة التكوين/البيئة (راجع skills في تكوين Gateway).

​
حدود بيئة التشغيل

بُنيت بيئة تشغيل الوكيل المضمنة على نواة وكيل Pi (النماذج، الأدوات، ومسار الموجّهات). إدارة الجلسات، والاكتشاف، وتوصيل الأدوات، وتسليم القنوات هي طبقات يملكها OpenClaw فوق تلك النواة.

​
الجلسات

تُخزّن نصوص الجلسات بصيغة JSONL في:
  • ~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl
معرّف الجلسة ثابت ويختاره OpenClaw. لا تُقرأ مجلدات الجلسات القديمة من أدوات أخرى.

​
التوجيه أثناء البث

عندما يكون وضع الطابور steer، تُحقن الرسائل الواردة في التشغيل الحالي. يُسلَّم التوجيه الموضوع في الطابور بعد أن ينتهي دور المساعد الحالي من تنفيذ استدعاءات أدواته، وقبل استدعاء LLM التالي. يفرغ Pi جميع رسائل التوجيه المعلّقة معًا لوضع steer؛ أما queue القديم فيفرغ رسالة واحدة لكل حدّ نموذج. لم يعد التوجيه يتخطى استدعاءات الأدوات المتبقية من رسالة المساعد الحالية. عندما يكون وضع الطابور followup أو collect، تُحتجز الرسائل الواردة حتى ينتهي الدور الحالي، ثم يبدأ دور وكيل جديد بالحمولات الموضوعة في الطابور. راجع الطابور وطابور التوجيه لمعرفة سلوك الوضع والحدود. يرسل بث الكتل كتل المساعد المكتملة فور انتهائها؛ وهو متوقف افتراضيًا (agents.defaults.blockStreamingDefault: "off"). اضبط الحد عبر agents.defaults.blockStreamingBreak (text_end مقابل message_end؛ الافتراضي هو text_end). تحكم في تقطيع الكتل المرن باستخدام agents.defaults.blockStreamingChunk (الافتراضي 800-1200 حرف؛ يفضل فواصل الفقرات، ثم الأسطر الجديدة؛ والجمل أخيرًا). ادمج المقاطع المبثوثة باستخدام agents.defaults.blockStreamingCoalesce لتقليل الإزعاج الناتج عن السطور المفردة (دمج قائم على الخمول قبل الإرسال). تتطلب القنوات غير Telegram ضبط *.blockStreaming: true صراحةً لتمكين ردود الكتل. تُصدر ملخصات الأدوات المطوّلة عند بدء الأداة (من دون إزالة ارتداد)؛ وتبث واجهة التحكم مخرجات الأدوات عبر أحداث الوكيل عند توفرها. مزيد من التفاصيل: البث + التقطيع.

​
مراجع النماذج

تُحلَّل مراجع النماذج في التكوين (مثل agents.defaults.model وagents.defaults.models) بالتقسيم عند أول / فقط.
  • استخدم provider/model عند تكوين النماذج.
  • إذا كان معرّف النموذج نفسه يحتوي على / (بنمط OpenRouter)، فأدرج بادئة المزوّد (مثال: openrouter/moonshotai/kimi-k2).
  • إذا حذفت المزوّد، يحاول OpenClaw استخدام اسم مستعار أولًا، ثم مطابقة مزوّد مكوّن فريدة لمعرّف النموذج المحدد بالضبط، وبعدها فقط يعود إلى المزوّد الافتراضي المكوّن. إذا لم يعد ذلك المزوّد يوفّر النموذج الافتراضي المكوّن، يعود OpenClaw إلى أول مزوّد/نموذج مكوّن بدلًا من إظهار افتراضي قديم لمزوّد مُزال.

​
التكوين (الحد الأدنى)

كحد أدنى، اضبط:
  • agents.defaults.workspace
  • channels.whatsapp.allowFrom (موصى به بشدة)
التالي: دردشات المجموعات 🦞

​
ذات صلة