OpenClaw کو نئی مشین پر منتقل کرنا¶
یہ گائیڈ OpenClaw Gateway کو ایک مشین سے دوسری مشین پر آن بورڈنگ دوبارہ کیے بغیر منتقل کرنے کا طریقہ بیان کرتی ہے۔
تصوراتی طور پر مائیگریشن سادہ ہے:
- اسٹیٹ ڈائریکٹری کی کاپی کریں (
$OPENCLAW_STATE_DIR، بطورِ طے شدہ:~/.openclaw/) — اس میں کنفیگ، تصدیق، سیشنز، اور چینل اسٹیٹ شامل ہوتی ہے۔ - اپنی ورک اسپیس کی کاپی کریں (
~/.openclaw/workspace/بطورِ طے شدہ) — اس میں آپ کے ایجنٹ فائلز (میموری، پرامپٹس وغیرہ) شامل ہوتے ہیں۔
لیکن پروفائلز، اجازتوں، اور جزوی کاپیوں کے حوالے سے عام مسائل (footguns) موجود ہیں۔
شروع کرنے سے پہلے (آپ کیا منتقل کر رہے ہیں)¶
1. اپنی اسٹیٹ ڈائریکٹری کی شناخت کریں¶
زیادہ تر انسٹالیشنز ڈیفالٹ استعمال کرتی ہیں:
- اسٹیٹ ڈائریکٹری:
~/.openclaw/
لیکن اگر آپ یہ استعمال کرتے ہیں تو یہ مختلف ہو سکتی ہے:
--profile <name>(اکثر~/.openclaw-<profile>/بن جاتا ہے)OPENCLAW_STATE_DIR=/some/path
اگر آپ کو یقین نہیں، تو پرانے مشین پر یہ چلائیں:
openclaw status
آؤٹ پٹ میں OPENCLAW_STATE_DIR / پروفائل کے حوالہ جات تلاش کریں۔ اگر آپ متعدد گیٹ ویز چلاتے ہیں تو ہر پروفائل کے لیے یہی عمل دہرائیں۔
2. اپنی ورک اسپیس کی شناخت کریں¶
عام ڈیفالٹس:
~/.openclaw/workspace/(تجویز کردہ ورک اسپیس)- وہ حسبِ ضرورت فولڈر جو آپ نے خود بنایا ہو
آپ کی ورک اسپیس وہ جگہ ہے جہاں MEMORY.md، USER.md، اور memory/*.md جیسی فائلیں موجود ہوتی ہیں۔
3. یہ سمجھیں کہ کیا محفوظ رہے گا¶
اگر آپ دونوں اسٹیٹ ڈائریکٹری اور ورک اسپیس کی کاپی کرتے ہیں، تو آپ محفوظ رکھتے ہیں:
- Gateway کنفیگریشن (
openclaw.json) - تصدیقی پروفائلز / API کلیدیں / OAuth ٹوکنز
- سیشن ہسٹری + ایجنٹ اسٹیٹ
- چینل اسٹیٹ (مثلاً WhatsApp لاگ اِن/سیشن)
- آپ کی ورک اسپیس فائلیں (میموری، Skills نوٹس وغیرہ)
اگر آپ صرف ورک اسپیس کی کاپی کرتے ہیں (مثلاً Git کے ذریعے)، تو آپ محفوظ نہیں رکھتے:
- سیشنز
- اسناد
- چینل لاگ اِنز
یہ سب $OPENCLAW_STATE_DIR کے تحت موجود ہوتے ہیں۔
مائیگریشن کے مراحل (تجویز کردہ)¶
مرحلہ 0 — بیک اپ بنائیں (پرانے مشین پر)¶
پرانے مشین پر، پہلے گیٹ وے بند کریں تاکہ کاپی کے دوران فائلیں تبدیل نہ ہوں:
openclaw gateway stop
(اختیاری مگر تجویز کردہ) اسٹیٹ ڈائریکٹری اور ورک اسپیس کو آرکائیو کریں:
# Adjust paths if you use a profile or custom locations
cd ~
tar -czf openclaw-state.tgz .openclaw
tar -czf openclaw-workspace.tgz .openclaw/workspace
اگر آپ کے پاس متعدد پروفائلز/اسٹیٹ ڈائریکٹریز ہیں (مثلاً ~/.openclaw-main، ~/.openclaw-work)، تو ہر ایک کو آرکائیو کریں۔
مرحلہ 1 — نئی مشین پر OpenClaw انسٹال کریں¶
نئی مشین پر، CLI (اور اگر ضروری ہو تو Node) انسٹال کریں:
- دیکھیں: Install
اس مرحلے پر اگر آن بورڈنگ ایک نیا ~/.openclaw/ بنا دے تو کوئی مسئلہ نہیں — آپ اگلے مرحلے میں اسے اوور رائٹ کر دیں گے۔
مرحلہ 2 — اسٹیٹ ڈائریکٹری + ورک اسپیس کو نئی مشین پر کاپی کریں¶
دونوں کاپی کریں:
$OPENCLAW_STATE_DIR(ڈیفالٹ~/.openclaw/)- آپ کی ورک اسپیس (ڈیفالٹ
~/.openclaw/workspace/)
عام طریقے:
scpکے ذریعے ٹاربالز کاپی کر کے ایکسٹریکٹ کریںrsync -aکے ذریعے SSH پر- ایکسٹرنل ڈرائیو
کاپی کے بعد، یقینی بنائیں:
- مخفی ڈائریکٹریز شامل کی گئی ہوں (مثلاً
.openclaw/) - گیٹ وے چلانے والے صارف کے لیے فائل ملکیت درست ہو
مرحلہ 3 — Doctor چلائیں (مائیگریشنز + سروس مرمت)¶
نئی مشین پر:
openclaw doctor
Doctor ایک “محفوظ اور بورنگ” کمانڈ ہے۔ یہ سروسز کی مرمت کرتا ہے، کنفیگ مائیگریشنز لاگو کرتا ہے، اور عدم مطابقت پر خبردار کرتا ہے۔
پھر:
openclaw gateway restart
openclaw status
عام مسائل (اور ان سے بچاؤ)¶
مسئلہ: پروفائل / اسٹیٹ ڈائریکٹری عدم مطابقت¶
اگر آپ نے پرانا گیٹ وے کسی پروفائل (یا OPENCLAW_STATE_DIR) کے ساتھ چلایا تھا، اور نیا گیٹ وے مختلف استعمال کر رہا ہے، تو آپ کو یہ علامات نظر آئیں گی:
- کنفیگ تبدیلیاں لاگو نہ ہونا
- چینلز کا غائب ہونا / لاگ آؤٹ ہو جانا
- خالی سیشن ہسٹری
حل: گیٹ وے/سروس کو اسی پروفائل/اسٹیٹ ڈائریکٹری کے ساتھ چلائیں جسے آپ نے منتقل کیا ہے، پھر دوبارہ یہ چلائیں:
openclaw doctor
مسئلہ: صرف openclaw.json کی کاپی کرنا¶
openclaw.json کافی نہیں ہے۔ بہت سے پرووائیڈرز اس جگہ اسٹیٹ محفوظ کرتے ہیں:
$OPENCLAW_STATE_DIR/credentials/$OPENCLAW_STATE_DIR/agents/<agentId>/...
ہمیشہ پوری $OPENCLAW_STATE_DIR فولڈر کو منتقل کریں۔
مسئلہ: اجازتیں / ملکیت¶
اگر آپ نے روٹ کے طور پر کاپی کیا یا صارف تبدیل کیا، تو گیٹ وے اسناد/سیشنز پڑھنے میں ناکام ہو سکتا ہے۔
حل: یقینی بنائیں کہ اسٹیٹ ڈائریکٹری اور ورک اسپیس گیٹ وے چلانے والے صارف کی ملکیت ہوں۔
مسئلہ: ریموٹ/لوکل موڈ کے درمیان منتقلی¶
- اگر آپ کی UI (WebUI/TUI) ریموٹ گیٹ وے کی طرف اشارہ کرتی ہے، تو سیشن اسٹور اور ورک اسپیس ریموٹ ہوسٹ کے پاس ہوتی ہے۔
- اپنے لیپ ٹاپ کی منتقلی سے ریموٹ گیٹ وے کی اسٹیٹ منتقل نہیں ہوگی۔
اگر آپ ریموٹ موڈ میں ہیں، تو گیٹ وے ہوسٹ کو منتقل کریں۔
مسئلہ: بیک اپس میں راز (secrets)¶
$OPENCLAW_STATE_DIR میں راز شامل ہوتے ہیں (API keys، OAuth tokens، WhatsApp اسناد)۔ بیک اپس کو پروڈکشن رازوں کی طرح سنبھالیں:
- انکرپٹ کر کے محفوظ کریں
- غیر محفوظ چینلز پر شیئر کرنے سے گریز کریں
- اگر افشا ہونے کا شبہ ہو تو کلیدیں تبدیل کریں
تصدیقی چیک لسٹ¶
نئی مشین پر تصدیق کریں:
openclaw statusگیٹ وے کے چلنے کو ظاہر کرتا ہو- آپ کے چینلز اب بھی منسلک ہوں (مثلاً WhatsApp کو دوبارہ جوڑی بنانے کی ضرورت نہ ہو)
- ڈیش بورڈ کھلتا ہو اور موجودہ سیشنز دکھاتا ہو
- آپ کی ورک اسپیس فائلیں (میموری، کنفیگز) موجود ہوں