OpenClaw کی تنصیب اور OmniProxy کی ترتیب

OpenClaw آپ کے اپنے کمپیوٹر پر انسٹال ہونے والا ایک AI اسسٹنٹ ہے۔ آپ اس سے براہ راست ٹیلیگرام، ڈسکارڈ، واٹس ایپ، یا فیشو (Feishu) کے ذریعے بات کر سکتے ہیں، بغیر کسی دوسری چیٹ ونڈو کو کھلا رکھے۔ بات چیت اور ریکارڈز اسی کمپیوٹر پر رہتے ہیں، اور یہ مقامی طور پر بعد کے مراحل کو جاری رکھ سکتا ہے۔

شروع کرنے سے پہلے

OpenClaw کے لیے Node 24.16 یا اس سے بعد کا ورژن درکار ہے۔ آپ Node 26.1 یا اس سے بعد کا ورژن بھی استعمال کر سکتے ہیں، جس میں Node 26 کی سفارش کی جاتی ہے۔ Node وہ رن ٹائم ماحول فراہم کرتا ہے جو OpenClaw کے لیے درکار ہے۔

اسے macOS، Linux، اور Windows پر انسٹال کیا جا سکتا ہے۔ اگر کمپیوٹر میں Node کا مناسب ورژن نہیں ہے، تو انسٹالیشن اسکرپٹ خود بخود ایک تیار کر دے گا: macOS پر Node 26 اور Linux پر Node 24 LTS۔ pnpm صرف اس وقت درکار ہوتا ہے جب OpenClaw کو سورس سے بنایا جا رہا ہو۔

اگر Node کا پرانا ورژن پہلے سے انسٹال ہے، تو آپ کو اسے پہلے ان انسٹال کرنے کی ضرورت نہیں ہے۔ 2026-10-09 کو ٹیسٹنگ کے دوران، اس کمپیوٹر پر سسٹم Node ورژن 24.2.0 تھا، جو درکار 24.16 سے کم تھا، اور نان انٹرایکٹو انسٹالیشن اسکرپٹ نے خود بخود Node 24.21.0 تیار کر لیا۔

کیا آپ ونڈو چاہتے ہیں

ڈیسک ٹاپ ساتھی

• Windows پر Hub انسٹالر استعمال کریں
• macOS پر GitHub DMG استعمال کریں
• مقامی گیٹ وے کو ابتدائی سیٹ اپ کے دوران انسٹال کیا جا سکتا ہے

سرکاری طور پر تجویز کردہ

انسٹالیشن اسکرپٹ

• macOS Linux WSL2
• Windows پر PowerShell استعمال کریں
• آپ --no-onboard شامل کر سکتے ہیں

Node پہلے سے انسٹال ہے

پیکیج مینیجر

• npm pnpm یا bun
• پھر onboard چلائیں
• Node ورژن کے لیے انسٹالیشن صفحہ دیکھیں

پہلی بار انسٹال اور لانچ کریں

آپ گرافیکل ونڈو کے ساتھ ڈیسک ٹاپ ساتھی انسٹال کر سکتے ہیں، یا براہ راست ٹرمینل کے ذریعے انسٹال کر سکتے ہیں۔ گیٹ وے وہ مقامی سروس ہے جو پیغامات وصول کرنے، ماڈلز کو کال کرنے، اور نتائج واپس کرنے کی ذمہ دار ہے۔ آپ ڈیسک ٹاپ ساتھی کو پہلی بار کھولتے وقت اسے ترتیب دے سکتے ہیں۔

اگر آپ ونڈو چاہتے ہیں

• Windows: OpenClawCompanion-Setup-x64.exe یا OpenClawCompanion-Setup-arm64.exe ڈاؤن لوڈ اور چلائیں۔ انسٹالر دستخط شدہ ہے اور اس میں ترتیبات، ٹرے اسٹیٹس، چیٹ، اور نوڈ موڈز شامل ہیں۔
• macOS: OpenClaw کے GitHub ریلیز سے OpenClaw .dmg ڈاؤن لوڈ کریں۔ dmg کو ترجیح دیں، حالانکہ آپ .zip بھی استعمال کر سکتے ہیں۔ انسٹالیشن کے بعد OpenClaw.app کھولیں۔ اگر اس ورژن میں macOS فائل شامل نہیں ہے، تو macOS ایپ صفحہ پر عمل کریں۔

پہلی بار کھولتے وقت، آپ OpenClaw کو اس کمپیوٹر پر گیٹ وے تیار کرنے دے سکتے ہیں یا موجودہ ریموٹ گیٹ وے سے منسلک ہو سکتے ہیں۔

ٹرمینل کے ذریعے انسٹال کریں

macOS، Linux، اور WSL2 کے لیے، استعمال کریں:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell کے لیے، استعمال کریں:

iwr -useb https://openclaw.ai/install.ps1 | iex

اسکرپٹ موجودہ سسٹم کا پتہ لگاتا ہے، ضرورت پڑنے پر Node انسٹال کرتا ہے، OpenClaw انسٹال کرتا ہے، اور پھر ابتدائی آن بورڈنگ کا عمل شروع کرتا ہے۔ آن بورڈنگ کا عمل آپ کو پہلی بار سیٹ اپ کرنے میں رہنمائی کرتا ہے۔

اگر آپ ابھی آن بورڈنگ شروع نہیں کرنا چاہتے ہیں، تو اس کے بجائے macOS، Linux، اور WSL2 پر درج ذیل استعمال کریں:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Windows پر، سرکاری -NoOnboard آپشن استعمال کریں:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

اگر آپ پہلے سے ہی Node کا انتظام خود کرتے ہیں، تو آپ npm، pnpm، یا bun بھی استعمال کر سکتے ہیں۔ npm 12 یا npm 11.16 اور بعد کے ورژن کے ساتھ، چلائیں:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

npm 11.15 اور اس سے پہلے کے ورژن کے لیے، --allow-scripts=openclaw کو ہٹا دیں۔ pnpm استعمال کرتے وقت، --allow-build=openclaw شامل کریں۔ درست فرق کے لیے انسٹالیشن صفحہ دیکھیں۔

انسٹالیشن کے بعد، یہ تین کمانڈز ترتیب سے چلائیں:

openclaw --version
openclaw doctor
openclaw gateway status

openclaw --version ورژن دکھاتا ہے، openclaw doctor عام ماحولیاتی مسائل کی جانچ کرتا ہے، اور openclaw gateway status دکھاتا ہے کہ آیا گیٹ وے چل رہا ہے۔ بنیادی انسٹالیشن تب ہی مکمل ہوتی ہے جب تینوں کمانڈز معمول کا آؤٹ پٹ دیں۔

اگر ٹرمینل رپورٹ کرتا ہے کہ اسے openclaw نہیں مل رہا، تو npm گلوبل بن ڈائریکٹری عام طور پر PATH سے غائب ہوتی ہے۔ PATH ان مقامات کی فہرست ہے جہاں ٹرمینل پروگرام تلاش کرتا ہے۔ node -v، npm prefix -g، اور echo "$PATH" کے آؤٹ پٹ کا موازنہ کریں، متعلقہ بن ڈائریکٹری کو PATH میں شامل کریں، اور پھر ٹرمینل کو دوبارہ کھولیں۔

اگر ~/.openclaw میں پہلے سے ہی کوئی کنفیگریشن موجود ہے جو فی الحال استعمال میں ہے، تو ڈیفالٹ انسٹالیشن اسکرپٹ اس ڈائریکٹری کا استعمال کرے گا۔ موجودہ کنفیگریشن کو تبدیل کیے بغیر ایک الگ کاپی انسٹال کرنے کے لیے، نان انٹرایکٹو اسکرپٹ چلائیں اور ایک نئی ڈائریکٹری بتائیں:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard اس اسکرپٹ کا ڈیفالٹ رویہ ہے۔ 2026-10-09 کو، اس کمانڈ نے OpenClaw 2026.9.9 انسٹال کیا۔ انسٹالیشن کے بعد، ڈائریکٹری کے bin فولڈر سے openclaw ایگزیکیوٹیبل چلائیں۔

OmniProxy سے کنکشن ویلیوز حاصل کریں

پہلے تصدیق کریں کہ OmniProxy چل رہا ہے، پھر اس کی ماڈل لسٹ کھولیں اور درج ذیل تین ویلیوز تیار کریں:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl وہ پتہ ہے جس پر OpenClaw ماڈل کی درخواستیں بھیجتا ہے، اور اسے /v1 پر ختم ہونا چاہیے۔ OmniProxy سے منسلک ہوتے وقت، api کے لیے openai-completions استعمال کریں۔ اسے صرف تب openai-responses میں تبدیل کریں اگر ماڈل واقعی /v1/responses کے ذریعے کام کرتا ہے۔

ماڈل ID لسٹ میں ماڈل کا مکمل شناخت کنندہ ہے۔ اسے بالکل اسی طرح کاپی کریں جیسا کہ دکھایا گیا ہے، بشمول کوئی بھی سلیش۔ درج ذیل دو نام 2026-10-09 تک فراہم کنندہ کی دستاویزات کے حوالے ہیں؛ اگر وہ لسٹ میں ظاہر نہ ہوں تو انہیں استعمال نہ کریں: claude-sonnet-5-5، gpt-6-luna۔

اگر گیٹ وے کلید کی توثیق نہیں کرتا، تب بھی apiKey میں ایک ویلیو ہونی چاہیے۔ آپ ایک پلیس ہولڈر سٹرنگ استعمال کر سکتے ہیں جو صرف اس کمپیوٹر پر استعمال ہوتی ہے۔ کسی ریپوزٹری میں اصلی کلید کمٹ نہ کریں۔

ٹول کنفیگریشن درج کریں

ایک فراہم کنندہ (Provider) کو کنکشن کی ترتیبات کے ایک سیٹ کے طور پر سمجھا جا سکتا ہے جسے OpenClaw ماڈل سروس تلاش کرنے کے لیے استعمال کرتا ہے۔ یہاں، فراہم کنندہ کا نام omniproxy ہے۔

ٹرمینل میں درج ذیل کمانڈ چلائیں، پتہ، کلید، اور دو ماڈل IDs کو اپنی ویلیوز سے تبدیل کریں:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

یہ کمانڈ فراہم کنندہ اور ماڈل لسٹ کو کنفیگریشن میں لکھتی ہے۔ کمانڈ کے کامیاب ہونے کے بعد آپ کو گیٹ وے کو دوبارہ شروع کرنے کی ضرورت نہیں ہے۔

اگلا، ڈیفالٹ ماڈل بتائیں۔ ماڈل کا حوالہ omniproxy/ اور اس کے بعد ماڈل ID پر مشتمل ہوتا ہے۔ ID میں پہلے سے موجود ہر سلیش کو برقرار رکھیں۔ اگر ماڈل لسٹ میں ID نیچے دیے گئے مختصر نام سے لمبی ہے، تو لسٹ سے مکمل ویلیو استعمال کریں:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

reasoning، input، cost، contextWindow، اور maxTokens سب کو چھوڑا جا سکتا ہے۔ جب وہ فراہم نہیں کیے جاتے ہیں، تو ٹیکسٹ ماڈلز کو ڈیفالٹس کا استعمال کرتے ہوئے ہینڈل کیا جاتا ہے۔

آپ انہی ترتیبات کو براہ راست کنفیگریشن فائل میں بھی لکھ سکتے ہیں۔ مرکزی کنفیگریشن میں، فراہم کنندہ models.providers کے تحت واقع ہے۔ ہر ایجنٹ کی اپنی models.json بھی ہو سکتی ہے؛ ایک ایجنٹ ایک اسسٹنٹ انسٹینس ہے جو اصل میں کام وصول کرتا ہے اور ماڈلز کو کال کرتا ہے۔ فائل ~/.openclaw/agents/ کے تحت متعلقہ ایجنٹ ڈائریکٹری میں agent/models.json پر واقع ہے۔

اگر اس models.json میں ایک نان ایمپٹی baseUrl ہے، تو یہ مرکزی کنفیگریشن میں پتے کو اوور رائڈ کر دیتا ہے۔

انسٹالیشن چیک کریں

تین کمانڈز

• openclaw --version
• openclaw doctor
• gateway status

کنفیگریشن

models.providers

• baseUrl /v1 پر ختم ہوتا ہے
• api کو completions پر سیٹ کریں
• کم از کم ماڈل id بتائیں

منتخب کریں

provider/model

• پرائمری کے لیے یہ حوالہ استعمال کریں
• کلید کے لیے ماحولیاتی متغیر کو ترجیح دیں
• گیٹ وے لسٹ کو سچائی کا ذریعہ استعمال کریں

ایک حقیقی کام کی تصدیق کریں

ایک باقاعدہ پروجیکٹ ڈائریکٹری درج کریں اور ایک بہت مختصر پیغام بھیجیں۔ کمانڈ میں ماڈل کے حوالہ کو اپنی مکمل ماڈل ID سے تبدیل کریں:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

--local اس ایجنٹ ٹاسک کو مقامی طور پر چلاتا ہے، --model اس رن کے لیے استعمال ہونے والے ماڈل کو بتاتا ہے، اور --timeout 300 زیادہ سے زیادہ انتظار کا وقت 300 سیکنڈ پر سیٹ کرتا ہے۔

ایک حقیقی ماڈل کا جواب ٹرمینل میں ظاہر ہونا چاہیے۔ 2026-10-09 کو، OpenClaw 2026.9.9 نے اس کمانڈ کا استعمال کرتے ہوئے جواب موصول کیا۔ پہلی کال میں ایک یا دو منٹ لگ سکتے ہیں۔

اگر اصل غلطی Request timed out before a response was generated ظاہر ہوتی ہے، تو --timeout میں اضافہ کریں اور درخواست دوبارہ بھیجیں۔ اس کا مطلب عام طور پر یہ ہے کہ انتظار کا وقت ناکافی تھا اور ضروری نہیں کہ پتہ غلط ہو۔

مختصر جواب کامیاب ہونے کے بعد، اس سے ایک مقامی فائل پڑھنے کو کہیں جو آپ بتاتے ہیں۔ پھر OmniProxy کے درخواست ریکارڈز کھولیں اور ریکارڈ میں دکھائے گئے ماڈل ID اور ذریعہ کی تصدیق کریں۔ صرف ورژن کمانڈ یا ڈاکٹر سے آؤٹ پٹ کا مطلب یہ نہیں ہے کہ ماڈل کنکشن مکمل طور پر ترتیب دیا گیا ہے۔

انسٹالیشن

کمانڈ جواب دیتی ہے

• ورژن نمبر دکھایا گیا ہے
• ڈاکٹر کوئی رکاوٹ نہیں بتاتا
• گیٹ وے اسٹیٹس پڑھنے کے قابل ہے

ٹاسک

اس نے ایک چھوٹا کام مکمل کیا

• مثال کے طور پر، ایک مقامی فائل پڑھیں
• جواب کوئی غلطی نہیں ہے
• ماڈل کا حوالہ درست ہے

لاگز

گیٹ وے میں نظر آتے ہیں

• ذریعہ OpenClaw ہے
• ماڈل ID مماثل ہے
• کلید ریپوزٹری میں شامل نہیں کی گئی تھی

عام غلطیاں

• openclaw نہیں مل سکا: npm گلوبل بن ڈائریکٹری کو PATH میں شامل کریں، پھر ٹرمینل کو دوبارہ کھولیں۔ اگر آپ نے کسی مخصوص ڈائریکٹری میں انسٹال کیا ہے، تو اس ڈائریکٹری کے bin فولڈر سے ایگزیکیوٹیبل چلائیں۔
• node -v 24.16 سے کم ہے: آپ کو پہلے پرانے ورژن کو ان انسٹال کرنے کی ضرورت نہیں ہے۔ انسٹالیشن اسکرپٹ کے ذریعے تیار کردہ Node ورژن چیک کریں، یا انسٹالیشن صفحہ پر بیان کردہ 24.16+ یا 26.1+ استعمال کریں۔ Node 26 کی سفارش کی جاتی ہے۔
• ماڈل ظاہر نہیں ہوتا: ماڈل کو models.providers کے تحت models سرنی (array) میں شامل ہونا چاہیے اور کم از کم وہی id ہونا چاہیے۔ صرف agents.defaults.models سیٹ کرنے سے خود بخود کوئی نیا ماڈل رجسٹر نہیں ہوتا۔
• 400 جواب ڈویلپر کردار کا ذکر کرتا ہے: جب ایڈریس ہوسٹ api.openai.com نہ ہو، تو ڈیفالٹ رکھیں اور supportsDeveloperRole کو true پر سیٹ نہ کریں۔ اگر اسے true پر سیٹ بھی کیا جائے، تب بھی اسے اوور رائڈ کر دیا جائے گا۔
• یہ جلدی ٹائم آؤٹ ہو جاتا ہے: پتہ تبدیل کرنے سے پہلے --timeout کو 300 سیکنڈ سے زیادہ بڑھائیں۔
• gpt-6-luna منتخب کرنے کے بعد ٹول کالز ناکام ہو جاتی ہیں: یہ چیٹ کمپلیشنز کو سپورٹ کرتا ہے؛ چیٹ کمپلیشنز میں فنکشن کالنگ صرف تب سپورٹ کی جاتی ہے جب reasoning_effort، none ہو۔ اگر لسٹ میں ID اس سے مختلف ہے، تو لسٹ میں دکھائی گئی ID استعمال کریں۔
• پتہ تک پہنچا نہیں جا سکتا: تصدیق کریں کہ OmniProxy چل رہا ہے، کہ baseUrl، /v1 پر ختم ہوتا ہے، اور یہ کہ کنفیگریشن میں لکھا گیا پتہ قابل رسائی ہے۔ دیگر نجی نیٹ ورک کے پتوں کی الگ سے اجازت ہونی چاہیے۔
• کنفیگریشن کے بعد بھی درخواستیں دوسرے پتے پر جاتی ہیں: چیک کریں کہ آیا اس ایجنٹ کے models.json میں کوئی مختلف baseUrl موجود ہے۔

سرکاری حوالہ جات

انسٹالیشن کے مراحل کے لیے، OpenClaw install دیکھیں۔ کسٹم فراہم کنندہ کنفیگریشن کے لیے، Custom providers اور configuration fields دیکھیں۔ مثالوں میں استعمال ہونے والی ماڈل IDs کے لیے، Claude model overview اور GPT-6 Luna سے موازنہ کریں۔

اپنے ذاتی OmniProxy ترتیب سے ہر پلیس ہولڈر کو ویلیوز سے تبدیل کریں۔ کبھی بھی ایک حقیقی کنج شائع نہ کریں۔

محض محفوظ نتیجہ یا HTTP 200 مکمل ایجنٹ مطابقت کی ضمانت نہیں دیتا۔ OmniProxy کی کال ریکارڈ میں ذریعہ اور ماڈل چیک کریں۔

سرکاری ذرائع · OpenClaw ↗