الأساسيات

مساحة عمل الوكيل

مساحة العمل هي موطن الوكيل. وهي دليل العمل الوحيد المستخدم لأدوات الملفات وللحصول على سياق مساحة العمل. حافظ على خصوصيتها وعاملها كذاكرة. هذه مساحة منفصلة عن ~/.openclaw/، الذي يخزن التكوين، بيانات الاعتماد، والجلسات. مهم: مساحة العمل هي دليل العمل الحالي الافتراضي، وليست حاوية عزل صارمة. تحل الأدوات المسارات النسبية مقابل مساحة العمل، لكن المسارات المطلقة لا تزال تستطيع الوصول إلى أماكن أخرى على المضيف ما لم يتم تمكين العزل. إذا كنت بحاجة إلى عزل، استخدم agents.defaults.sandbox (و/أو تكوين العزل لكل وكيل). عند تمكين العزل وعدم كون workspaceAccess هو "rw"، تعمل الأدوات داخل مساحة عمل معزولة تحت ~/.openclaw/sandboxes، وليس مساحة العمل الخاصة بمضيفك.

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

• الافتراضي: ~/.openclaw/workspace
• إذا تم تعيين OPENCLAW_PROFILE وليس "default"، يصبح الافتراضي هو ~/.openclaw/workspace-.
• تجاوز الإعداد في ~/.openclaw/openclaw.json:

{
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}

سيقوم openclaw onboard، أو openclaw configure، أو openclaw setup بإنشاء مساحة العمل وتهيئة ملفات التمهيد إذا كانت مفقودة. نسخ التمهيد المعزولة تقبل فقط الملفات العادية داخل مساحة العمل؛ يتم تجاهل الروابط الرمزية أو الصلبة التي تشير إلى خارج مساحة العمل المصدر. إذا كنت تدير ملفات مساحة العمل بنفسك بالفعل، يمكنك تعطيل إنشاء ملفات التمهيد:

{ agent: { skipBootstrap: true } }

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

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

خريطة ملفات مساحة العمل (معنى كل ملف)

هذه هي الملفات القياسية التي يتوقعها OpenClaw داخل مساحة العمل:

• AGENTS.md
  • تعليمات التشغيل للوكيل وكيفية استخدامه للذاكرة.
  • يتم تحميلها في بداية كل جلسة.
  • مكان جيد للقواعد، الأولويات، وتفاصيل "كيفية التصرف".
• SOUL.md
  • الشخصية، النبرة، والحدود.
  • يتم تحميلها في كل جلسة.
• USER.md
  • من هو المستخدم وكيفية مخاطبته.
  • يتم تحميلها في كل جلسة.
• IDENTITY.md
  • اسم الوكيل، جوهره، والرمز التعبيري الخاص به.
  • يتم إنشاؤه/تحديثه أثناء طقوس التمهيد.
• TOOLS.md
  • ملاحظات حول أدواتك المحلية والاتفاقيات.
  • لا يتحكم في توفر الأدوات؛ إنه مجرد توجيه.
• HEARTBEAT.md
  • قائمة مراجعة صغيرة اختيارية لتشغيلات نبض القلب.
  • حافظ على قصره لتجنب حرق الرموز المميزة.
• BOOT.md
  • قائمة مراجعة اختيارية للبدء يتم تنفيذها عند إعادة تشغيل البوابة عند تمكين الخطافات الداخلية.
  • حافظ على قصره؛ استخدم أداة الرسائل للإرسالات الصادرة.
• BOOTSTRAP.md
  • طقوس التشغيل الأول لمرة واحدة.
  • يتم إنشاؤها فقط لمساحة عمل جديدة تمامًا.
  • احذفها بعد اكتمال الطقوس.
• memory/YYYY-MM-DD.md
  • سجل الذاكرة اليومي (ملف واحد لكل يوم).
  • يُوصى بقراءة ملف اليوم + ملف الأمس عند بدء الجلسة.
• MEMORY.md (اختياري)
  • ذاكرة طويلة الأمد منتقاة.
  • يتم تحميلها فقط في الجلسة الرئيسية الخاصة (وليس في سياقات المجموعة/المشتركة).

راجع الذاكرة لمعرفة سير العمل والتفريغ التلقائي للذاكرة.

• skills/ (اختياري)
  • مهارات خاصة بمساحة العمل.
  • تتجاوز المهارات المدارة/المجمعة عند تعارض الأسماء.
• canvas/ (اختياري)
  • ملفات واجهة المستخدم Canvas لعرض العقد (على سبيل المثال canvas/index.html).

إذا كان أي ملف تمهيد مفقودًا، يحقن OpenClaw علامة "ملف مفقود" في الجلسة ويستمر. يتم اقتطاع ملفات التمهيد الكبيرة عند حقنها؛ اضبط الحدود باستخدام agents.defaults.bootstrapMaxChars (الافتراضي: 20000) و agents.defaults.bootstrapTotalMaxChars (الافتراضي: 150000). يمكن لـ openclaw setup إعادة إنشاء الملفات الافتراضية المفقودة دون الكتابة فوق الملفات الموجودة.

ما الذي لا يوجد في مساحة العمل

توجد هذه الملفات تحت ~/.openclaw/ ويجب ألا تُحفظ في مستودع مساحة العمل:

• ~/.openclaw/openclaw.json (التكوين)
• ~/.openclaw/credentials/ (رموز OAuth، مفاتيح API)
• ~/.openclaw/agents//sessions/ (نصوص الجلسات + بيانات وصفية)
• ~/.openclaw/skills/ (المهارات المدارة)

إذا كنت بحاجة إلى نقل الجلسات أو التكوين، انسخها بشكل منفصل واحتفظ بها خارج التحكم في الإصدار.

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

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

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) إضافة مستودع بعيد خاص (خيارات سهلة للمبتدئين)

الخيار أ: واجهة GitHub على الويب

1. أنشئ مستودعًا جديدًا خاصًا على GitHub.
2. لا تقم بتهيئته باستخدام ملف README (لتجنب تعارضات الدمج).
3. انسخ عنوان URL البعيد HTTPS.
4. أضف المستودع البعيد وارفع الملفات:

git branch -M main
git remote add origin <https-url>
git push -u origin main

الخيار ب: GitHub CLI (gh)

gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push

الخيار ج: واجهة GitLab على الويب

1. أنشئ مستودعًا جديدًا خاصًا على GitLab.
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 لتهيئة أي ملفات مفقودة.
4. إذا كنت بحاجة إلى الجلسات، انسخ ~/.openclaw/agents//sessions/ من الجهاز القديم بشكل منفصل.

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

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

السياقOAuth