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

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/، الذي يخزن الإعدادات وبيانات الاعتماد والجلسات.
مساحة العمل هي دليل العمل الحالي الافتراضي، وليست صندوقًا معزولًا صارمًا. تحل الأدوات المسارات النسبية نسبةً إلى مساحة العمل، لكن المسارات المطلقة ما زال بإمكانها الوصول إلى أماكن أخرى على المضيف ما لم يكن العزل ممكّنًا. إذا كنت بحاجة إلى عزل، فاستخدم agents.defaults.sandbox (و/أو إعدادات العزل لكل وكيل).عند تمكين العزل وعدم ضبط workspaceAccess على "rw"، تعمل الأدوات داخل مساحة عمل معزولة ضمن ~/.openclaw/sandboxes، وليس داخل مساحة عمل المضيف.

​
الموقع الافتراضي

  • الافتراضي: ~/.openclaw/workspace
  • إذا كان OPENCLAW_PROFILE مضبوطًا وليس "default"، يصبح الافتراضي ~/.openclaw/workspace-<profile>.
  • يمكنك التجاوز في ~/.openclaw/openclaw.json:
{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
    },
  },
}
سينشئ openclaw onboard أو openclaw configure أو openclaw setup مساحة العمل ويضيف ملفات التمهيد الأولية إذا كانت مفقودة.
تقبل نسخ بذور العزل الملفات العادية داخل مساحة العمل فقط؛ ويتم تجاهل الأسماء المستعارة عبر الروابط الرمزية/الروابط الصلبة التي تشير إلى خارج مساحة العمل المصدر.
إذا كنت تدير ملفات مساحة العمل بنفسك بالفعل، فيمكنك تعطيل إنشاء ملفات التمهيد: 
{ agents: { defaults: { skipBootstrap: true } } }

​
مجلدات مساحة عمل إضافية

قد تكون التثبيتات الأقدم أنشأت ~/openclaw. قد يؤدي إبقاء عدة أدلة لمساحات العمل إلى التباس في المصادقة أو انحراف في الحالة، لأن مساحة عمل واحدة فقط تكون نشطة في كل مرة.
التوصية: احتفظ بمساحة عمل نشطة واحدة. إذا لم تعد تستخدم المجلدات الإضافية، فأرشفها أو انقلها إلى سلة المهملات (مثلًا trash ~/openclaw). إذا كنت تحتفظ عمدًا بعدة مساحات عمل، فتأكد من أن agents.defaults.workspace يشير إلى المساحة النشطة.يحذّر openclaw doctor عندما يكتشف أدلة مساحة عمل إضافية.

​
خريطة ملفات مساحة العمل

هذه هي الملفات القياسية التي يتوقع OpenClaw وجودها داخل مساحة العمل:
تعليمات التشغيل للوكيل وكيف ينبغي له استخدام الذاكرة. تُحمّل عند بداية كل جلسة. مكان جيد للقواعد والأولويات وتفاصيل “كيفية التصرف”.
الشخصية والنبرة والحدود. تُحمّل في كل جلسة. الدليل: دليل شخصية SOUL.md.
من هو المستخدم وكيفية مخاطبته. يُحمّل في كل جلسة.
اسم الوكيل وطابعه ورمزه التعبيري. يُنشأ/يُحدّث أثناء طقس التمهيد.
ملاحظات عن أدواتك المحلية واصطلاحاتها. لا تتحكم في إتاحة الأدوات؛ فهي إرشادات فقط.
قائمة تحقق صغيرة اختيارية لتشغيلات Heartbeat. أبقها قصيرة لتجنب استهلاك الرموز.
قائمة تحقق اختيارية لبدء التشغيل تُشغّل تلقائيًا عند إعادة تشغيل Gateway (عند تمكين الخطافات الداخلية). أبقها قصيرة؛ واستخدم أداة الرسائل للإرسال الصادر.
طقس تشغيل أول لمرة واحدة. يُنشأ فقط لمساحة عمل جديدة تمامًا. احذفه بعد اكتمال الطقس.
سجل الذاكرة اليومي (ملف واحد لكل يوم). يُوصى بقراءة اليوم + أمس عند بدء الجلسة.
ذاكرة طويلة الأمد منتقاة: حقائق دائمة، وتفضيلات، وقرارات، وملخصات قصيرة. احتفظ بالسجلات المفصلة في memory/YYYY-MM-DD.md حتى تتمكن أدوات الذاكرة من استرجاعها عند الطلب دون حقنها في كل مطالبة. حمّل MEMORY.md فقط في الجلسة الرئيسية الخاصة (وليس في سياقات المشاركة/المجموعات). راجع الذاكرة لمعرفة سير العمل وتفريغ الذاكرة التلقائي.
Skills خاصة بمساحة العمل. موقع Skills الأعلى أولوية لتلك المساحة. يتجاوز Skills وكيل المشروع، وSkills الوكيل الشخصية، وSkills المُدارة، وSkills المضمّنة، وskills.load.extraDirs عند تعارض الأسماء.
ملفات واجهة Canvas لعروض العقد (مثل canvas/index.html).
إذا كان أي ملف تمهيد مفقودًا، يحقن OpenClaw علامة “ملف مفقود” في الجلسة ويتابع. تُقتطع ملفات التمهيد الكبيرة عند حقنها؛ اضبط الحدود باستخدام agents.defaults.bootstrapMaxChars (الافتراضي: 12000) وagents.defaults.bootstrapTotalMaxChars (الافتراضي: 60000). يستطيع openclaw setup إعادة إنشاء الافتراضيات المفقودة دون الكتابة فوق الملفات الموجودة.

​
ما ليس ضمن مساحة العمل

هذه العناصر موجودة ضمن ~/.openclaw/ ويجب ألا تُلتزم في مستودع مساحة العمل:
  • ~/.openclaw/openclaw.json (الإعدادات)
  • ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (ملفات مصادقة النموذج: OAuth + مفاتيح API)
  • ~/.openclaw/agents/<agentId>/agent/codex-home/ (حساب تشغيل Codex لكل وكيل، والإعدادات، وSkills، وplugins، وحالة السلسلة الأصلية)
  • ~/.openclaw/credentials/ (حالة القناة/المزوّد بالإضافة إلى بيانات استيراد OAuth القديمة)
  • ~/.openclaw/agents/<agentId>/sessions/ (نصوص الجلسات + البيانات الوصفية)
  • ~/.openclaw/skills/ (Skills مُدارة)
إذا كنت بحاجة إلى ترحيل الجلسات أو الإعدادات، فانسخها بشكل منفصل وأبقها خارج التحكم في الإصدارات.

​
النسخ الاحتياطي عبر Git (موصى به، خاص)

تعامل مع مساحة العمل كذاكرة خاصة. ضعها في مستودع git خاص بحيث تكون منسوخة احتياطيًا وقابلة للاسترداد. شغّل هذه الخطوات على الجهاز الذي يعمل عليه Gateway (فهذا هو مكان وجود مساحة العمل).
1

تهيئة المستودع

إذا كان git مثبتًا، تتم تهيئة مساحات العمل الجديدة تمامًا تلقائيًا. إذا لم تكن مساحة العمل هذه مستودعًا بالفعل، فشغّل:
cd ~/.openclaw/workspace
git init
git add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/
git commit -m "Add agent workspace"
2

إضافة مستودع بعيد خاص

  1. أنشئ مستودعًا خاصًا جديدًا على GitHub.
  2. لا تهيئه بملف README (لتجنب تعارضات الدمج).
  3. انسخ عنوان URL البعيد عبر HTTPS.
  4. أضف المستودع البعيد وادفع:
git branch -M main
git remote add origin <https-url>
git push -u origin main
3

التحديثات المستمرة

git status
git add .
git commit -m "Update memory"
git push

​
لا تلتزم الأسرار

حتى في مستودع خاص، تجنب تخزين الأسرار في مساحة العمل:
  • مفاتيح API أو رموز OAuth أو كلمات المرور أو بيانات الاعتماد الخاصة.
  • أي شيء ضمن ~/.openclaw/.
  • النسخ الخام من المحادثات أو المرفقات الحساسة.
إذا كان لا بد من تخزين مراجع حساسة، فاستخدم عناصر نائبة واحتفظ بالسر الحقيقي في مكان آخر (مدير كلمات مرور، أو متغيرات بيئة، أو ~/.openclaw/).
بداية مقترحة لملف .gitignore: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
نقل مساحة العمل إلى جهاز جديد

1

استنساخ المستودع

استنسخ المستودع إلى المسار المطلوب (الافتراضي ~/.openclaw/workspace).
2

تحديث الإعدادات

اضبط agents.defaults.workspace على ذلك المسار في ~/.openclaw/openclaw.json.
3

زرع الملفات المفقودة

شغّل openclaw setup --workspace <path> لزرع أي ملفات مفقودة.
4

نسخ الجلسات (اختياري)

إذا كنت بحاجة إلى الجلسات، فانسخ ~/.openclaw/agents/<agentId>/sessions/ من الجهاز القديم بشكل منفصل.

​
ملاحظات متقدمة

  • يمكن للتوجيه متعدد الوكلاء استخدام مساحات عمل مختلفة لكل وكيل. راجع توجيه القنوات لإعدادات التوجيه.
  • إذا كان agents.defaults.sandbox ممكّنًا، فيمكن للجلسات غير الرئيسية استخدام مساحات عمل عزل لكل جلسة ضمن agents.defaults.sandbox.workspaceRoot.

​
ذو صلة

  • Heartbeat - ملف مساحة العمل HEARTBEAT.md
  • العزل - الوصول إلى مساحة العمل في البيئات المعزولة
  • الجلسة - مسارات تخزين الجلسات
  • الأوامر الدائمة - التعليمات المستمرة في ملفات مساحة العمل