Asosiy tarkibga o'tish

​
Agent workspace

The workspace is the agent’s home. It is the only working directory used for file tools and for workspace context. Keep it private and treat it as memory. Bu ~/.openclaw/ dan alohida bo‘lib, u konfiguratsiya, hisob ma’lumotlari va sessions. Important: the workspace is the default cwd, not a hard sandbox. Tools resolve relative paths against the workspace, but absolute paths can still reach elsewhere on the host unless sandboxing is enabled. HEARTBEAT.md When sandboxing is enabled and workspaceAccess is not "rw", tools operate inside a sandbox workspace under ~/.openclaw/sandboxes, not your host workspace.

​
Standart joylashuv

  • Standart: ~/.openclaw/workspace
    1. Agar OPENCLAW_PROFILE o‘rnatilgan bo‘lsa va "default" bo‘lmasa, standart joy quyidagicha bo‘ladi ~/.openclaw/workspace-<profile>.
    1. ~/.openclaw/openclaw.json faylida almashtirish:
3. {
  agent: {
    workspace: "~/.openclaw/workspace",
  },
}
  1. openclaw onboard, openclaw configure yoki openclaw setup buyruqlari workspace’ni yaratadi va agar ular yo‘q bo‘lsa, bootstrap fayllarini boshlang‘ich holatda joylaydi.
  2. Agar siz workspace fayllarini allaqachon o‘zingiz boshqarsangiz, bootstrap fayllarini yaratishni o‘chirib qo‘yishingiz mumkin: 
6. { agent: { skipBootstrap: true } }

​
7. Qo‘shimcha workspace papkalari

  1. Eski o‘rnatishlar ~/openclaw ni yaratgan bo‘lishi mumkin. 9. Bir nechta workspace kataloglarini saqlab yurish chalkash autentifikatsiya yoki holatning siljishiga olib kelishi mumkin, chunki bir vaqtning o‘zida faqat bitta workspace faol bo‘ladi.
  2. Tavsiya: bitta faol workspace’ni saqlang. 11. Agar qo‘shimcha papkalardan endi foydalanmasangiz, ularni arxivlang yoki Chiqindiga ko‘chiring (masalan trash ~/openclaw).
  3. Agar siz ataylab bir nechta workspace’ni saqlasangiz, agents.defaults.workspace faol bo‘lganiga ishora qilayotganiga ishonch hosil qiling.
  4. openclaw doctor qo‘shimcha workspace kataloglarini aniqlaganda ogohlantiradi.

​
14. Workspace fayllari xaritasi (har bir fayl nimani anglatadi)

  1. Bular OpenClaw workspace ichida kutadigan standart fayllardir:
  • AGENTS.md
    • 17. Agent uchun ishlash ko‘rsatmalari va xotiradan qanday foydalanishi kerakligi.
      1. Har bir sessiya boshida yuklanadi.
      1. Qoidalar, ustuvorliklar va “qanday tutish kerak” tafsilotlari uchun yaxshi joy.
  • SOUL.md
    • 21. Persona, ohang va chegaralar.
      1. Har bir sessiyada yuklanadi.
  • USER.md
    • 24. Foydalanuvchi kimligi va unga qanday murojaat qilish.
      1. Har bir sessiyada yuklanadi.
  • IDENTITY.md
    • 27. Agentning nomi, kayfiyati (vibe) va emoji.
      1. Bootstrap marosimi davomida yaratiladi/yangilanadi.
  • TOOLS.md
    • 30. Mahalliy vositalaringiz va kelishuvlaringiz haqidagi eslatmalar.
      1. Vositalar mavjudligini boshqarmaydi; bu faqat yo‘l-yo‘riq.
  • README bilan boshlamang (merge konfliktlaridan qochish uchun).
    • 33. Heartbeat ishga tushirishlari uchun ixtiyoriy kichik chek-list.
      1. Tokenlarni bekorga sarflamaslik uchun qisqa tuting.
  • BOOT.md
    • 36. Ichki hook’lar yoqilganda gateway qayta ishga tushirilganda bajariladigan ixtiyoriy boshlang‘ich chek-list.
      1. Qisqa tuting; tashqi yuborishlar uchun message vositasidan foydalaning.
  • BOOTSTRAP.md
    • 39. Bir martalik birinchi ishga tushirish marosimi.
      1. Faqat mutlaqo yangi workspace uchun yaratiladi.
      1. Marosim tugagach, uni o‘chirib tashlang.
  • memory/YYYY-MM-DD.md
    • 43. Kundalik xotira jurnali (har kun uchun bitta fayl).
      1. Sessiya boshida bugungi + kechagini o‘qish tavsiya etiladi.
  • MEMORY.md (ixtiyoriy)
    • 46. Tanlab olingan uzoq muddatli xotira.
      1. Faqat asosiy, shaxsiy sessiyada yuklang (umumiy/guruh kontekstlarida emas).
  1. Ish jarayoni va avtomatik xotira tozalash uchun Memory ga qarang.
  • skills/ (ixtiyoriy)
    • 50. Workspace’ga xos ko‘nikmalar.
    • Overrides managed/bundled skills when names collide.
  • canvas/ (optional)
    • Canvas UI files for node displays (for example canvas/index.html).
If any bootstrap file is missing, OpenClaw injects a “missing file” marker into the session and continues. Large bootstrap files are truncated when injected; adjust the limit with agents.defaults.bootstrapMaxChars (default: 20000). openclaw setup can recreate missing defaults without overwriting existing files.

​
What is NOT in the workspace

These live under ~/.openclaw/ and should NOT be committed to the workspace repo:
  • ~/.openclaw/openclaw.json (config)
  • ~/.openclaw/credentials/ (OAuth tokens, API keys)
  • ~/.openclaw/agents/<agentId>/sessions/ (session transcripts + metadata)
  • ~/.openclaw/skills/ (managed skills)
If you need to migrate sessions or config, copy them separately and keep them out of version control. Treat the workspace as private memory. Put it in a private git repo so it is backed up and recoverable. Run these steps on the machine where the Gateway runs (that is where the workspace lives).

​
1. Initialize the repo

If git is installed, brand-new workspaces are initialized automatically. If this workspace is not already a repo, run: 
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. Add a private remote (beginner-friendly options)

Option A: GitHub web UI
  1. Create a new private repository on GitHub.
  2. Do not initialize with a README (avoids merge conflicts).
  3. Copy the HTTPS remote URL.
  4. Add the remote and push:
git branch -M main
git remote add origin <https-url>
git push -u origin main
Option B: GitHub CLI (gh) 
gh auth login
gh repo create openclaw-workspace --private --source . --remote origin --push
Option C: GitLab web UI
  1. Create a new private repository on GitLab.
  2. Do not initialize with a README (avoids merge conflicts).
  3. Copy the HTTPS remote URL.
  4. Add the remote and push:
git branch -M main
git remote add origin <https-url>
git push -u origin main

​
3. Ongoing updates

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

​
Do not commit secrets

Even in a private repo, avoid storing secrets in the workspace:
  • API keys, OAuth tokens, passwords, or private credentials.
  • Anything under ~/.openclaw/.
  • Raw dumps of chats or sensitive attachments.
If you must store sensitive references, use placeholders and keep the real secret elsewhere (password manager, environment variables, or ~/.openclaw/). Suggested .gitignore starter: 
.DS_Store
.env
**/*.key
**/*.pem
**/secrets*

​
Moving the workspace to a new machine

  1. Clone the repo to the desired path (default ~/.openclaw/workspace).
  2. Set agents.defaults.workspace to that path in ~/.openclaw/openclaw.json.
  3. Run openclaw setup --workspace <path> to seed any missing files.
    1. Agar sizga sessiyalar kerak bo‘lsa, ~/.openclaw/agents/<agentId>/sessions/ papkasini eski mashinadan alohida nusxalab oling.

​
2) Kengaytirilgan eslatmalar

    1. Ko‘p agentli marshrutlash har bir agent uchun turli ish maydonlaridan foydalanishi mumkin. OpenClaw pi-mono dan olingan bitta ichki agent runtime’ni ishga tushiradi.
    1. Agar agents.defaults.sandbox yoqilgan bo‘lsa, asosiy bo‘lmagan sessiyalar agents.defaults.sandbox.workspaceRoot ostida sessiya-bo‘yicha sandbox ish maydonlaridan foydalanishi mumkin.