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

مساحة العمل هي موطن الوكيل. وهي دليل العمل الوحيد المستخدم لأدوات الملفات ولسياق مساحة العمل. أبقِها خاصة وتعامل معها كذاكرة.

هذا منفصل عن ~/.openclaw/، الذي يخزن الإعدادات وبيانات الاعتماد والجلسات.

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

• الافتراضي: ~/.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. قد يؤدي إبقاء عدة أدلة لمساحة العمل إلى التباس في المصادقة أو انحراف الحالة، لأن مساحة عمل واحدة فقط تكون نشطة في كل مرة.

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

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

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

توجد هذه العناصر تحت ~/.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 (وهو المكان الذي تعيش فيه مساحة العمل).

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"

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

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

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

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

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

بادئ .gitignore مقترح:

.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

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

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

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

# ذو صلة

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