سیٹ اپ¶
MEDIA:<path-or-url> شامل کریں (بغیر اسپیس کے)۔
10. اگر آپ پہلی بار سیٹ اپ کر رہے ہیں تو Getting Started سے آغاز کریں۔
آخری تازہ کاری: 2026-01-01
TL;DR¶
- حسبِ ضرورت تبدیلیاں ریپو کے باہر رکھیں:
~/.openclaw/workspace(workspace) +~/.openclaw/openclaw.json(config)۔ - مستحکم ورک فلو: macOS ایپ انسٹال کریں؛ اسے بنڈل شدہ Gateway چلانے دیں۔
- انتہائی جدید ورک فلو:
pnpm gateway:watchکے ذریعے Gateway خود چلائیں، پھر macOS ایپ کو Local موڈ میں اٹیچ ہونے دیں۔
پیشگی تقاضے (سورس سے)¶
- Node
>=22 pnpm- Docker (اختیاری؛ صرف کنٹینرائزڈ سیٹ اپ/e2e کے لیے — Docker دیکھیں)
حسبِ ضرورت بنانے کی حکمتِ عملی (تاکہ اپ ڈیٹس نقصان نہ پہنچائیں)¶
اگر آپ “100% میرے مطابق” اور آسان اپ ڈیٹس چاہتے ہیں، تو اپنی تخصیصات یہاں رکھیں:
- کنفیگ:
~/.openclaw/openclaw.json(JSON/JSON5 طرز) - ورک اسپیس:
~/.openclaw/workspace(skills، prompts، memories؛ اسے نجی git ریپو بنائیں)
ایک بار بوٹ اسٹرَیپ کریں:
openclaw setup
اسی ریپو کے اندر سے مقامی CLI انٹری استعمال کریں:
openclaw setup
اگر ابھی عالمی انسٹال موجود نہیں، تو اسے pnpm openclaw setup کے ذریعے چلائیں۔
اس ریپو سے Gateway چلائیں¶
pnpm build کے بعد، آپ پیکج شدہ CLI براہِ راست چلا سکتے ہیں:
node openclaw.mjs gateway --port 18789 --verbose
مستحکم ورک فلو (macOS ایپ پہلے)¶
- OpenClaw.app انسٹال کریں اور لانچ کریں (مینو بار)۔
- آن بورڈنگ/اجازتوں کی چیک لسٹ مکمل کریں (TCC پرامپٹس)۔
- یقینی بنائیں کہ Gateway Local ہے اور چل رہا ہے (ایپ اسے منیج کرتی ہے)۔
- سرفیسز لنک کریں (مثال: WhatsApp):
openclaw channels login
- سینیٹی چیک:
openclaw health
اگر آپ کی بلڈ میں آن بورڈنگ دستیاب نہیں:
openclaw setupچلائیں، پھرopenclaw channels login، پھر Gateway دستی طور پر شروع کریں (openclaw gateway)۔
انتہائی جدید ورک فلو (Gateway ٹرمینل میں)¶
مقصد: TypeScript Gateway پر کام کرنا، ہاٹ ری لوڈ حاصل کرنا، اور macOS ایپ UI کو منسلک رکھنا۔
0. (اختیاری) macOS ایپ بھی سورس سے چلائیں¶
اگر آپ macOS ایپ کو بھی جدید ترین رکھنا چاہتے ہیں:
./scripts/restart-mac.sh
1. ڈیو Gateway شروع کریں¶
pnpm install
pnpm gateway:watch
gateway:watch واچ موڈ میں gateway چلاتا ہے اور TypeScript تبدیلیوں پر ری لوڈ کرتا ہے۔
2. macOS ایپ کو اپنے چلتے ہوئے Gateway کی طرف پوائنٹ کریں¶
OpenClaw.app میں:
- کنکشن موڈ: Local ایپ کنفیگر شدہ پورٹ پر چلتے ہوئے gateway سے اٹیچ ہو جائے گی۔
3. تصدیق کریں¶
- ایپ کے اندر Gateway اسٹیٹس “Using existing gateway …” دکھانا چاہیے
- یا CLI کے ذریعے:
openclaw health
عام مسائل¶
- غلط پورٹ: Gateway WS بطورِ طے شدہ
ws://127.0.0.1:18789ہے؛ ایپ + CLI کو ایک ہی پورٹ پر رکھیں۔ - اسٹیٹ کہاں رہتی ہے:
- اسناد:
~/.openclaw/credentials/ - سیشنز:
~/.openclaw/agents/<agentId>/sessions/ - لاگز:
/tmp/openclaw/
اسناد کے ذخیرے کا نقشہ¶
تصدیق کی ڈیبگنگ یا بیک اپ کا فیصلہ کرتے وقت اس کا استعمال کریں:
- WhatsApp:
~/.openclaw/credentials/whatsapp/<accountId>/creds.json - Telegram بوٹ ٹوکن: کنفیگ/env یا
channels.telegram.tokenFile - Discord بوٹ ٹوکن: کنفیگ/env (ٹوکن فائل ابھی سپورٹڈ نہیں)
- Slack ٹوکنز: کنفیگ/env (
channels.slack.*) - جوڑی بنانے کی اجازت فہرستیں:
~/.openclaw/credentials/<channel>-allowFrom.json - ماڈل آتھنٹیکیشن پروفائلز:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json - لیگیسی OAuth امپورٹ:
~/.openclaw/credentials/oauth.jsonمزید تفصیل: سکیورٹی۔
اپ ڈیٹنگ (آپ کی سیٹ اپ کو نقصان پہنچائے بغیر)¶
~/.openclaw/workspaceاور~/.openclaw/کو “آپ کا مواد” رکھیں؛ ذاتی prompts/کنفیگ کوopenclawریپو میں مت ڈالیں۔- سورس اپ ڈیٹ کرنا:
git pull+pnpm install(جب لاک فائل بدلی ہو) +pnpm gateway:watchاستعمال کرتے رہیں۔
Linux (systemd یوزر سروس)¶
- وزرڈ کی تفصیلات کے لیے Onboarding Wizard دیکھیں۔ 12. لینکس انسٹالز systemd user سروس استعمال کرتے ہیں۔ 13. ڈیفالٹ طور پر، systemd لاگ آؤٹ/آئیڈل پر یوزر سروسز بند کر دیتا ہے، جس سے گیٹ وے ختم ہو جاتا ہے۔ 14. آن بورڈنگ آپ کے لیے lingering کو فعال کرنے کی کوشش کرتا ہے (sudo کا مطالبہ ہو سکتا ہے)۔
sudo loginctl enable-linger $USER
- اگر یہ اب بھی بند ہو تو چلائیں: See Gateway runbook for the systemd notes.
متعلقہ دستاویزات¶
- Gateway runbook (فلیگز، نگرانی، پورٹس)
- Gateway configuration (کنفیگ اسکیما + مثالیں)
- Discord اور Telegram (reply tags + replyToMode سیٹنگز)
- OpenClaw assistant setup
- macOS app (gateway لائف سائیکل)