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

​
وقت تشغيل الوكيل

يشغّل OpenClaw وقت تشغيل وكيل مضمّنًا واحدًا.

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

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

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

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

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

الأدوات الأساسية (read/exec/edit/write وأدوات النظام ذات الصلة) متاحة دائمًا، مع الخضوع لسياسة الأدوات. وتكون 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 configuration).

​
حدود وقت التشغيل

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

​
الجلسات

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

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

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

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

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

​
الإعداد (الحد الأدنى)

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