OpenClaw’ni yangi mashinaga ko‘chirish¶

Ushbu qo‘llanma OpenClaw Gateway’ni bir mashinadan boshqasiga onboarding’ni qayta bajarilmasdan ko‘chiradi.

Migratsiya kontseptual jihatdan sodda:

• Holat katalogini nusxalang ($OPENCLAW_STATE_DIR, standart: ~/.openclaw/) — bu konfiguratsiya, autentifikatsiya, sessiyalar va kanal holatini o‘z ichiga oladi.
• Workspace’ingizni nusxalang (standart bo‘yicha ~/.openclaw/workspace/) — bu agent fayllaringizni (xotira, promptlar va hokazo) o‘z ichiga oladi.

Ammo profillar, ruxsatlar va qisman nusxalar bilan bog‘liq keng tarqalgan xatolar mavjud.

Boshlashdan oldin (nimani ko‘chiryapsiz)¶

1. Identify your state directory¶

Ko‘pchilik o‘rnatishlar standart sozlamadan foydalanadi:

• Holat katalogi: ~/.openclaw/

Ammo quyidagilardan foydalansangiz, u boshqacha bo‘lishi mumkin:

• --profile <name> (odatda ~/.openclaw-<profile>/ ga aylanadi)
• OPENCLAW_STATE_DIR=/some/path

Agar ishonchingiz komil bo‘lmasa, eski kompyuterda quyidagini ishga tushiring:

openclaw status

Chiqishda OPENCLAW_STATE_DIR / profil tilga olingan joylarni qidiring. Agar bir nechta Gateway ishga tushirgan bo‘lsangiz, har bir profil uchun takrorlang.

2. Identify your workspace¶

Keng tarqalgan standartlar:

• ~/.openclaw/workspace/ (tavsiya etilgan ish maydoni)
• siz yaratgan maxsus papka

Your workspace is where files like MEMORY.md, USER.md, and memory/*.md live.

3. Understand what you will preserve¶

If you copy both the state dir and workspace, you keep:

• Gateway configuration (openclaw.json)
• Auth profiles / API keys / OAuth tokens
• Session history + agent state
• Channel state (e.g. WhatsApp login/session)
• Your workspace files (memory, skills notes, etc.)

If you copy only the workspace (e.g., via Git), you do not preserve:

• sessions
• credentials
• channel logins

Those live under $OPENCLAW_STATE_DIR.

Migration steps (recommended)¶

Step 0 — Make a backup (old machine)¶

On the old machine, stop the gateway first so files aren’t changing mid-copy:

openclaw gateway stop

(Optional but recommended) archive the state dir and workspace:

# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw

tar -czf openclaw-workspace.tgz .openclaw/workspace

If you have multiple profiles/state dirs (e.g. ~/.openclaw-main, ~/.openclaw-work), archive each.

Step 1 — Install OpenClaw on the new machine¶

On the new machine, install the CLI (and Node if needed):

• See: Install

At this stage, it’s OK if onboarding creates a fresh ~/.openclaw/ — you will overwrite it in the next step.

Step 2 — Copy the state dir + workspace to the new machine¶

Copy both:

• $OPENCLAW_STATE_DIR (default ~/.openclaw/)
• your workspace (default ~/.openclaw/workspace/)

Common approaches:

• scp the tarballs and extract
• rsync -a over SSH
• external drive

After copying, ensure:

• Hidden directories were included (e.g. .openclaw/)
• File ownership is correct for the user running the gateway

1. 3-qadam — Doktorni ishga tushirish (migratsiyalar + xizmatlarni tiklash)¶

2. yangi mashinada:

3. openclaw doctor

4. Doctor — bu “xavfsiz va zerikarli” buyruq. 5. U xizmatlarni tuzatadi, konfiguratsiya migratsiyalarini qo‘llaydi va nomuvofiqliklar haqida ogohlantiradi.

5. So‘ng:

7. openclaw gateway restart
openclaw status

8. Keng tarqalgan xatolar (va ularni qanday oldini olish)¶

9. Xato: profil / state-dir nomuvofiqligi¶

10. Agar eski gateway’ni profil (yoki OPENCLAW_STATE_DIR) bilan ishga tushirgan bo‘lsangiz va yangi gateway boshqasidan foydalansa, quyidagi alomatlarni ko‘rasiz:

• 11. konfiguratsiya o‘zgarishlari kuchga kirmaydi
• 12. kanallar yo‘qolgan / tizimdan chiqib ketgan
• 13. bo‘sh sessiya tarixi

14. Yechim: migratsiya qilingan xuddi shu profil/state dir’dan foydalanib gateway/xizmatni ishga tushiring, so‘ng yana ishga tushiring:

15. openclaw doctor

16. Xato: faqat openclaw.json ni ko‘chirish¶

17. openclaw.json yetarli emas. 18. Ko‘plab provayderlar holatni quyida saqlaydi:

• 19. $OPENCLAW_STATE_DIR/credentials/
• 20. $OPENCLAW_STATE_DIR/agents/<agentId>/...

21. Har doim butun $OPENCLAW_STATE_DIR papkasini migratsiya qiling.

22. Xato: ruxsatlar / egalik¶

23. Agar root sifatida ko‘chirgan bo‘lsangiz yoki foydalanuvchini o‘zgartirgan bo‘lsangiz, gateway credential’lar/sessiyalarni o‘qiy olmasligi mumkin.

24. Yechim: state dir va workspace gateway’ni ishga tushirayotgan foydalanuvchiga tegishli ekanini ta’minlang.

25. Xato: masofaviy/mahalliy rejimlar o‘rtasida migratsiya¶

• 26. Agar UI (WebUI/TUI) masofaviy gateway’ga ulanayotgan bo‘lsa, sessiya ombori va workspace masofaviy xostga tegishli bo‘ladi.
• 27. Noutbukingizni migratsiya qilish masofaviy gateway’ning holatini ko‘chirmaydi.

28. Agar masofaviy rejimda bo‘lsangiz, gateway xostini migratsiya qiling.

29. Xato: zaxira nusxalardagi sirlar¶

30. $OPENCLAW_STATE_DIR ichida sirlar mavjud (API kalitlari, OAuth tokenlari, WhatsApp credential’lari). 31. Zaxira nusxalarini ishlab chiqarish sirlaridek ko‘ring:

• 32. shifrlangan holda saqlang
• 33. xavfsiz bo‘lmagan kanallar orqali ulashishdan saqlaning
• 34. oshkor bo‘lganidan shubhalansangiz, kalitlarni aylantiring

35. Tekshiruv ro‘yxati¶

36. Yangi mashinada quyidagilarni tasdiqlang:

• 37. openclaw status gateway ishlayotganini ko‘rsatadi
• 38. Kanallaringiz hanuz ulangan (masalan, WhatsApp qayta juftlashni talab qilmaydi)
• 39. Boshqaruv paneli ochiladi va mavjud sessiyalarni ko‘rsatadi
• 40. Workspace fayllaringiz (xotira, konfiguratsiyalar) mavjud

41. Bog‘liq¶

• 42. Doctor
• 43. Gateway nosozliklarini bartaraf etish
• 44. OpenClaw ma’lumotlarini qayerda saqlaydi?