Fundamentals

بيئة تشغيل الوكيل

يشغّل 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 في سياق المشروع ويضيف إرشادات تمهيد إلى مطالبة النظام للطقس الأولي بدلًا من نسخه إلى رسالة المستخدم. إذا حذفته بعد إكمال الطقس، فلا ينبغي إعادة إنشائه عند عمليات إعادة التشغيل اللاحقة.

بعد ملاحظة مساحة عمل، يحتفظ OpenClaw أيضًا بعلامة تصديق في دليل الحالة لمسار مساحة العمل. إذا اختفت مساحة عمل تم التصديق عليها مؤخرًا أو مُسحت، يرفض بدء التشغيل إعادة بذر BOOTSTRAP.md بصمت؛ استعد مساحة العمل أو استخدم إعادة ضبط إعداد كاملة بحيث تُمسح مساحة العمل والعلامة معًا.

لتعطيل إنشاء ملفات التمهيد بالكامل (لمساحات العمل المجهزة مسبقًا)، عيّن:

json5

{ agents: { defaults: { 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 على مجلدات مجمّعة مثل <workspace>/skills/personal/foo/SKILL.md؛ تظل Skill معروضة باسم frontmatter المسطح الخاص بها، مثل foo.

يمكن تقييد Skills عبر التكوين/البيئة (راجع skills في تكوين Gateway).

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

وقت تشغيل الوكيل المضمّن مملوك لـ OpenClaw: يشارك اكتشاف النماذج، وتوصيل الأدوات، وتجميع المطالبات، وإدارة الجلسات، وتسليم القنوات سطح وقت تشغيل متكاملًا واحدًا.

الجلسات

تُخزّن نصوص الجلسات بصيغة JSONL في:

~/.openclaw/agents/<agentId>/sessions/<SessionId>.jsonl

معرّف الجلسة ثابت ويختاره OpenClaw. لا تتم قراءة مجلدات الجلسات القديمة من أدوات أخرى.

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

تُوجّه المطالبات الواردة التي تصل في منتصف التشغيل إلى التشغيل الحالي افتراضيًا. يتم تسليم التوجيه بعد انتهاء دور المساعد الحالي من تنفيذ استدعاءات أدواته، قبل استدعاء LLM التالي، ولم يعد يتخطى استدعاءات الأدوات المتبقية من رسالة المساعد الحالية.

/queue steer هو سلوك التشغيل النشط الافتراضي. تجعل /queue followup و /queue collect الرسائل تنتظر دورًا لاحقًا بدلًا من التوجيه. أما /queue interrupt فيلغي التشغيل النشط بدلًا من ذلك. راجع قائمة الانتظار وقائمة انتظار التوجيه لمعرفة سلوك قائمة الانتظار والحدود.

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

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

تُحلّل مراجع النماذج في التكوين (مثل agents.defaults.model وagents.defaults.models) بالتقسيم عند أول /.

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

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

كحد أدنى، عيّن:

agents.defaults.workspace
channels.whatsapp.allowFrom (موصى به بشدة)

التالي: محادثات المجموعات 🦞