فضای کاری عامل

فضای کاری خانهٔ عامل است: دایرکتوری کاری‌ای که برای ابزارهای فایل و زمینهٔ فضای کاری استفاده می‌شود. آن را خصوصی نگه دارید و مانند حافظه با آن رفتار کنید.

این فضا از ~/.openclaw/ جدا است؛ آن محل پیکربندی، اطلاعات احراز هویت و نشست‌ها را نگه می‌دارد.

مکان پیش‌فرض

• پیش‌فرض: ~/.openclaw/workspace
• اگر OPENCLAW_PROFILE تنظیم شده و برابر با "default" نباشد، مقدار پیش‌فرض به ~/.openclaw/workspace-<profile> تغییر می‌کند.
• در صورت تنظیم، OPENCLAW_WORKSPACE_DIR هر دو مورد بالا را نادیده می‌گیرد.
• فضای کاری عامل‌های غیراصلی (agents.entries.*) که فضای کاری صریحی ندارند، به <state-dir>/workspace-<agentId> نگاشت می‌شود، نه فضای کاری مشترک پیش‌فرض.

بازنویسی در ~/.openclaw/openclaw.json:

{  agents: {    defaults: {      workspace: "~/.openclaw/workspace",    },  },}

بازنویسی مختص هر عامل: agents.entries.*.workspace.

openclaw onboard، openclaw configure یا openclaw setup فضای کاری را ایجاد می‌کنند و اگر فایل‌های راه‌اندازی اولیه وجود نداشته باشند، آن‌ها را مقداردهی می‌کنند.

اگر فایل‌های فضای کاری را خودتان مدیریت می‌کنید، ایجاد فایل‌های راه‌اندازی اولیه را غیرفعال کنید:

{ agents: { defaults: { skipBootstrap: true } } }

پوشه‌های اضافی فضای کاری

نصب‌های قدیمی‌تر ممکن است ~/openclaw را ایجاد کرده باشند. نگه‌داشتن چند دایرکتوری فضای کاری می‌تواند باعث سردرگمی در احراز هویت یا واگرایی وضعیت شود، زیرا در هر لحظه فقط یک فضای کاری فعال است.

نقشهٔ فایل‌های فضای کاری

فایل‌های استانداردی که OpenClaw انتظار دارد در فضای کاری وجود داشته باشند:

چه چیزهایی در فضای کاری نیستند

این موارد زیر ~/.openclaw/ قرار دارند و نباید در مخزن فضای کاری ثبت شوند:

• ~/.openclaw/openclaw.json (پیکربندی)
• ~/.openclaw/state/openclaw.sqlite (وضعیت راه‌اندازی و گواهی‌های فضای کاری مشترک)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (پروفایل‌های احراز هویت مدل: OAuth + کلیدهای API)
• ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (ردیف‌های نشست، رونوشت‌ها و وضعیت زمان اجرای مختص هر عامل)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (حساب زمان اجرای Codex مختص هر عامل، پیکربندی، Skills، plugins و وضعیت بومی رشته)
• ~/.openclaw/credentials/ (وضعیت کانال/ارائه‌دهنده به‌همراه داده‌های قدیمی واردشدهٔ OAuth)
• ~/.openclaw/agents/<agentId>/sessions/ (منابع مهاجرت قدیمی و مصنوعات بایگانی/پشتیبانی)
• ~/.openclaw/skills/ (Skills مدیریت‌شده)

اگر لازم است نشست‌ها یا پیکربندی را منتقل کنید، آن‌ها را جداگانه کپی کنید و خارج از کنترل نسخه نگه دارید.

نسخه‌های قدیمی‌تر OpenClaw فایل‌های جانبی فضای کاری openclaw-workspace-state.json، .openclaw/workspace-state.json و .attested را می‌نوشتند. زمان اجرای فعلی برای این وضعیت فقط از پایگاه‌دادهٔ SQLite مشترک استفاده می‌کند. اگر Doctor یکی از این فایل‌ها را گزارش کرد، openclaw doctor --fix را اجرا کنید؛ Doctor وضعیت قدیمی معتبر را وارد می‌کند و فقط پس از تأیید ردیف‌های پایگاه‌داده، فایل مبدأ را حذف می‌کند.

پشتیبان‌گیری با 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

اطلاعات محرمانه را commit نکنید

نمونهٔ آغازین پیشنهادی برای .gitignore:

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

انتقال فضای کاری به یک ماشین جدید

نکات پیشرفته

• مسیریابی چندعاملی می‌تواند از طریق agents.entries.*.workspace برای هر عامل از فضای کاری متفاوتی استفاده کند. برای پیکربندی مسیریابی، مسیریابی کانال را ببینید.
• اگر agents.defaults.sandbox فعال باشد، نشست‌های غیراصلی می‌توانند از فضای کاری سندباکس مختص هر نشست زیر agents.defaults.sandbox.workspaceRoot استفاده کنند.

مرتبط

• Heartbeat - فایل فضای کاری HEARTBEAT.md
• سندباکس - دسترسی به فضای کاری در محیط‌های سندباکس‌شده
• نشست - مسیرهای ذخیره‌سازی نشست
• دستورهای دائمی - دستورالعمل‌های پایدار در فایل‌های فضای کاری