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

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

هذا منفصل عن ~/.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 runtime لكل وكيل، والإعدادات، وSkills، وplugins، وحالة الخيط الأصلية)
• ~/.openclaw/credentials/ (حالة القناة/الموفر بالإضافة إلى بيانات استيراد OAuth القديمة)
• ~/.openclaw/agents/<agentId>/sessions/ (نصوص الجلسات + البيانات الوصفية)
• ~/.openclaw/skills/ (Skills المدارة)

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

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

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

شغّل هذه الخطوات على الجهاز الذي يعمل عليه Gateway (حيث توجد مساحة العمل).

cd ~/.openclaw/workspacegit initgit add AGENTS.md SOUL.md TOOLS.md IDENTITY.md USER.md HEARTBEAT.md memory/git commit -m "Add agent workspace"

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

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

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

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

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

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

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

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

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

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

ذات صلة

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