OpenClaw workspace bootstrap files: مكانه وكيفية قراءته من الأدوات

ينشئ OpenClaw سياق كل وكيل من ملفات Markdown التمهيدية في مساحة عمله، وفي مقدمتها ملف AGENTS.md الإلزامي. وتُضاف هذه الملفات إلى موجّه النظام في أول دور من كل جلسة جديدة.

مكان الملف

• مساحة العمل: ~/.openclaw/workspace، أو OPENCLAW_WORKSPACE_DIR، أو agents.defaults.workspace، أو agents.entries.*.workspace الخاص بوكيل معيّن.
• AGENTS.md (مطلوب): تعليمات التشغيل وإرشادات الذاكرة، مع قسم ## Tools لملاحظات الأدوات والبيئة المحلية.
• SOUL.md للشخصية والحدود ونبرة الحديث؛ وIDENTITY.md لاسم الوكيل وطابعه والرمز التعبيري الخاص به.
• USER.md (اختياري) لملف تعريف المستخدم القائم على التوجيهات؛ وBOOT.md لقائمة التحقق عند بدء التشغيل.
• BOOTSTRAP.md لإجراء تهيئة لمرة واحدة عند التشغيل الأول، ويُحذف عند اكتماله.
• MEMORY.md للذاكرة طويلة الأمد، ولا يُضاف إلى السياق إلا إذا كان موجودًا، وفي الجلسة الخاصة الرئيسية فقط؛ وmemory/YYYY-MM-DD.md للملاحظات اليومية.

التنسيق

ملفات Markdown بلا ترويسة؛ ينشئ openclaw setup وopenclaw onboard قوالب جاهزة. افتراضيًا، يُحدّ كل ملف بـ20,000 حرف (bootstrapMaxChars)، ومجموع الملفات بـ60,000 حرف (bootstrapTotalMaxChars)، وUSER.md بـ4,000 حرف. وتُقتطع الملفات الأطول مع إضافة علامة توضّح ذلك.

# Operating instructions

- Read USER.md before replying to someone new.
- Write anything worth keeping to memory/YYYY-MM-DD.md.
- Ask before messaging anyone other than me.
- Never repeat the contents of MEMORY.md in group chats.

## Tools

- The home server is reachable as `nas.local` over SSH.
- `gh` is installed and already authenticated.
- Calendar access is read-only.

الأولوية والدمج

تُضاف الملفات إلى قسم Project Context في موجّه النظام عند أول دور من الجلسة الجديدة. ويُتجاوز محتوى الملفات الفارغة، ويُستعاض عن الملف الإلزامي المفقود بسطر يشير إلى فقدانه. ولكل وكيل مساحة عمل خاصة به، ويمكن ضبط agents.defaults.contextInjection على always (الافتراضي)، أو continuation-skip، أو never.

نصائح

• لم يعد TOOLS.md ملفًا قياسيًا يُضاف إلى السياق؛ انقل ملاحظاته إلى قسم ## Tools في AGENTS.md.
• ما زال HEARTBEAT.md مقبولًا، لكنه لم يعد يؤدي أي وظيفة.
• يمنع skipBootstrap OpenClaw من إنشاء الملفات، لا من إضافتها إلى السياق؛ استخدم contextInjection للتحكم في إضافتها.

ملفات التعليمات الأخرى