OpenClaw کی تنصیب اور OmniProxy کی کنفیگریشن

OpenClaw آپ کے اپنے کمپیوٹر پر انسٹال ہونے والا ایک AI اسسٹنٹ ہے۔ آپ اس سے براہ راست Telegram، Discord، WhatsApp، یا 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 استعمال کریں
• مقامی Gateway کو ابتدائی سیٹ اپ کے دوران انسٹال کیا جا سکتا ہے

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

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

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

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

پیکیج مینیجر

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

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

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

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

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

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

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

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 دکھاتا ہے کہ آیا Gateway چل رہا ہے۔ بنیادی انسٹالیشن تب ہی مکمل ہوتی ہے جب تینوں کمانڈز معمول کا آؤٹ پٹ دیں۔

اگر ٹرمینل رپورٹ کرتا ہے کہ اسے 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

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

اگلا، ڈیفالٹ ماڈل بتائیں۔ ماڈل کا حوالہ 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 کی تصدیق کریں۔ صرف ورژن کمانڈ یا ڈاکٹر سے آؤٹ پٹ کا مطلب یہ نہیں ہے کہ ماڈل کنکشن مکمل طور پر کنفیگر ہو چکا ہے۔

انسٹالیشن

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

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

ٹاسک

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

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

لاگز

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

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

عام غلطیاں

• openclaw نہیں مل سکا: npm گلوبل بن ڈائریکٹری کو PATH میں شامل کریں، پھر ٹرمینل کو دوبارہ کھولیں۔ اگر آپ نے کسی مخصوص ڈائریکٹری میں انسٹال کیا ہے، تو اس ڈائریکٹری کے bin فولڈر سے ایگزیکیوٹیبل چلائیں۔
• node -v 24.16 سے کم ہے: آپ کو پرانے ورژن کو پہلے ان انسٹال کرنے کی ضرورت نہیں ہے۔ انسٹالیشن اسکرپٹ کے ذریعے تیار کردہ Node ورژن چیک کریں، یا انسٹالیشن صفحہ پر بیان کردہ 24.16+ یا 26.1+ استعمال کریں۔ Node 26 کی سفارش کی جاتی ہے۔
• ماڈل ظاہر نہیں ہوتا: ماڈل کو models.providers کے تحت models سرنی میں شامل ہونا چاہیے اور اس کا کم از کم وہی id ہونا چاہیے۔ صرف agents.defaults.models سیٹ کرنے سے خود بخود کوئی نیا ماڈل رجسٹر نہیں ہوتا۔
• 400 جواب ڈویلپر رول کا ذکر کرتا ہے: جب ایڈریس ہوسٹ api.openai.com نہ ہو، تو ڈیفالٹ رکھیں اور supportsDeveloperRole کو true پر سیٹ نہ کریں۔ اگر اسے true پر سیٹ بھی کیا جائے، تب بھی اسے اوور رائڈ کر دیا جائے گا۔
• یہ جلدی ٹائم آؤٹ ہو جاتا ہے: ایڈریس تبدیل کرنے سے پہلے --timeout کو 300 سیکنڈ سے زیادہ بڑھائیں۔
• gpt-6-luna منتخب کرنے کے بعد ٹول کالز ناکام ہو جاتی ہیں: یہ Chat Completions کو سپورٹ کرتا ہے؛ Chat Completions میں فنکشن کالنگ صرف تب سپورٹ کی جاتی ہے جب 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 ↗