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

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

این از ~/.openclaw/ جداست؛ جایی که پیکربندی، اعتبارنامه‌ها، و نشست‌ها را ذخیره می‌کند.

# مکان پیش‌فرض

• پیش‌فرض: ~/.openclaw/workspace
• اگر OPENCLAW_PROFILE تنظیم شده باشد و برابر "default" نباشد، پیش‌فرض به ~/.openclaw/workspace-<profile> تبدیل می‌شود.
• بازنویسی در ~/.openclaw/openclaw.json:

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

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

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

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

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

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

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

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

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

این‌ها زیر ~/.openclaw/ قرار دارند و نباید به repo فضای کاری commit شوند:

• ~/.openclaw/openclaw.json (پیکربندی)
• ~/.openclaw/agents/<agentId>/agent/auth-profiles.json (پروفایل‌های auth مدل: OAuth + کلیدهای API)
• ~/.openclaw/agents/<agentId>/agent/codex-home/ (حساب runtime مخصوص هر عامل برای Codex، پیکربندی، skills، plugins، و وضعیت thread بومی)
• ~/.openclaw/credentials/ (وضعیت channel/provider به‌همراه داده‌های import قدیمی OAuth)
• ~/.openclaw/agents/<agentId>/sessions/ (transcriptهای نشست + metadata)
• ~/.openclaw/skills/ (skills مدیریت‌شده)

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

# پشتیبان‌گیری Git (توصیه‌شده، خصوصی)

با فضای کاری مانند حافظه‌ی خصوصی رفتار کنید. آن را در یک repo 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

# اسرار را commit نکنید

شروع‌کننده‌ی پیشنهادی .gitignore:

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

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

# نکات پیشرفته

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

# مرتبط

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