OpenClaw ইনস্টল করা এবং OmniProxy কনফিগার করা

OpenClaw হলো আপনার নিজের কম্পিউটারে ইনস্টল করা একটি এআই অ্যাসিস্ট্যান্ট। আপনি অন্য কোনো চ্যাট উইন্ডো খোলা না রেখেই সরাসরি টেলিগ্রাম, ডিসকর্ড, হোয়াটসঅ্যাপ বা ফেইশু (Feishu)-এর মাধ্যমে এর সাথে কথা বলতে পারেন। কথোপকথন এবং রেকর্ডগুলো এই কম্পিউটারেই থাকে এবং এটি স্থানীয়ভাবে পরবর্তী ধাপগুলো সম্পন্ন করতে পারে।

শুরু করার আগে

OpenClaw-এর জন্য Node 24.16 বা তার পরবর্তী সংস্করণ প্রয়োজন। আপনি Node 26.1 বা তার পরবর্তী সংস্করণও ব্যবহার করতে পারেন, তবে Node 26 ব্যবহারের পরামর্শ দেওয়া হয়। Node হলো OpenClaw-এর জন্য প্রয়োজনীয় রানটাইম এনভায়রনমেন্ট।

এটি macOS, Linux এবং Windows-এ ইনস্টল করা যায়। যদি কম্পিউটারে উপযুক্ত Node সংস্করণ না থাকে, তবে ইনস্টলেশন স্ক্রিপ্ট স্বয়ংক্রিয়ভাবে একটি প্রস্তুত করে দেবে: macOS-এ Node 26 এবং Linux-এ Node 24 LTS। সোর্স থেকে OpenClaw বিল্ড করার সময়ই কেবল pnpm প্রয়োজন হয়।

যদি আগে থেকেই Node-এর কোনো পুরোনো সংস্করণ ইনস্টল করা থাকে, তবে তা আগে আনইনস্টল করার প্রয়োজন নেই। ২০২৬-১০-০৯ তারিখে পরীক্ষার সময়, এই কম্পিউটারের সিস্টেম 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 .dmg OpenClaw-এর GitHub রিলিজ থেকে। 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 এই স্ক্রিপ্টের ডিফল্ট আচরণ। ২০২৬-১০-০৯ তারিখে, এই কমান্ডটি OpenClaw 2026.9.9 ইনস্টল করেছিল। ইনস্টলেশনের পর, চালান openclaw এক্সিকিউটেবল ফাইলটি ডিরেক্টরির bin ফোল্ডার থেকে।

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-এর সাথে সংযোগ করার সময়, ব্যবহার করুন openai-completions এর জন্য api। এটি পরিবর্তন করে openai-responses শুধুমাত্র তখনই করুন যদি মডেলটি আসলে /v1/responsesএর মাধ্যমে কাজ করে।

মডেল আইডি হলো তালিকায় মডেলের সম্পূর্ণ শনাক্তকারী। এটি ঠিক যেভাবে দেখানো হয়েছে সেভাবে কপি করুন, স্লাশসহ। নিচের দুটি নাম শুধুমাত্র ২০২৬-১০-০৯ তারিখ পর্যন্ত প্রোভাইডার ডকুমেন্টেশনের রেফারেন্স; যদি সেগুলো তালিকায় না থাকে তবে ব্যবহার করবেন না: claude-sonnet-5-5, gpt-6-luna।

এমনকি যদি গেটওয়ে কী (key) যাচাই না করে, তবুও apiKey অবশ্যই একটি মান ধারণ করতে হবে। আপনি একটি প্লেসহোল্ডার স্ট্রিং ব্যবহার করতে পারেন যা শুধুমাত্র এই কম্পিউটারে ব্যবহৃত হয়। কোনো রিয়েল কী (key) রিপোজিটরিতে কমিট করবেন না।

টুল কনফিগারেশন লিখুন

একটি প্রোভাইডারকে সংযোগ সেটিংসের একটি সেট হিসেবে বোঝা যেতে পারে যা OpenClaw একটি মডেল পরিষেবা খুঁজে পেতে ব্যবহার করে। এখানে, প্রোভাইডারের নাম omniproxy।

টার্মিনালে নিচের কমান্ডটি চালান, ঠিকানা, কী (key) এবং দুটি মডেল আইডি আপনার নিজের মান দিয়ে প্রতিস্থাপন করুন:

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/ এবং তার পরে মডেল আইডি দিয়ে। আইডিতে ইতিমধ্যে থাকা প্রতিটি স্লাশ বজায় রাখুন। যদি মডেল তালিকার আইডি নিচের ছোট নামের চেয়ে দীর্ঘ হয়, তবে তালিকা থেকে সম্পূর্ণ মানটি ব্যবহার করুন:

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

reasoning, input, cost, contextWindowএবং maxTokens সবই বাদ দেওয়া যেতে পারে। যখন সেগুলো প্রদান করা হয় না, তখন টেক্সট মডেলগুলো ডিফল্ট ব্যবহার করে হ্যান্ডেল করা হয়।

আপনি সরাসরি কনফিগারেশন ফাইলে একই সেটিংস লিখতে পারেন। প্রধান কনফিগারেশনে, প্রোভাইডারটি অবস্থিত models.providersএর অধীনে। প্রতিটি এজেন্টের নিজস্ব models.jsonথাকতে পারে; এজেন্ট হলো একটি অ্যাসিস্ট্যান্ট ইনস্ট্যান্স যা আসলে কাজ গ্রহণ করে এবং মডেল কল করে। ফাইলটি অবস্থিত agent/models.json এর মধ্যে সংশ্লিষ্ট এজেন্ট ডিরেক্টরিতে ~/.openclaw/agents/এর অধীনে।

যদি এই models.json একটি নন-এম্পটি baseUrlধারণ করে, তবে এটি প্রধান কনফিগারেশনের ঠিকানাকে ওভাররাইড করে।

ইনস্টলেশন পরীক্ষা করুন

তিনটি কমান্ড

• openclaw --version
• openclaw doctor
• gateway status

কনফিগারেশন

models.providers

• baseUrl /v1 দিয়ে শেষ হয়
• api-কে completions হিসেবে সেট করুন
• অন্তত মডেল আইডি নির্দিষ্ট করুন

নির্বাচন করুন

provider/model

• প্রাথমিকের জন্য এই রেফারেন্স ব্যবহার করুন
• কী (key)-এর জন্য একটি এনভায়রনমেন্ট ভেরিয়েবল পছন্দ করুন
• গেটওয়ে তালিকাকে সত্যের উৎস হিসেবে ব্যবহার করুন

একটি বাস্তব কাজ যাচাই করুন

একটি সাধারণ প্রজেক্ট ডিরেক্টরিতে প্রবেশ করুন এবং খুব ছোট একটি মেসেজ পাঠান। কমান্ডে মডেল রেফারেন্সটিকে আপনার সম্পূর্ণ মডেল আইডি দিয়ে প্রতিস্থাপন করুন:

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

--local এই এজেন্ট টাস্কটি স্থানীয়ভাবে চালায়, --model এই রানের জন্য কোন মডেল ব্যবহার করতে হবে তা নির্দিষ্ট করে, এবং --timeout 300 সর্বোচ্চ অপেক্ষার সময় ৩০০ সেকেন্ড সেট করে।

টার্মিনালে একটি বাস্তব মডেল রেসপন্স অবশ্যই আসতে হবে। ২০২৬-১০-০৯ তারিখে, OpenClaw 2026.9.9 এই কমান্ড ব্যবহার করে একটি রেসপন্স পেয়েছিল। প্রথম কলে এক বা দুই মিনিট সময় লাগতে পারে।

যদি মূল ত্রুটি Request timed out before a response was generated দেখা দেয়, তবে --timeout বাড়ান এবং অনুরোধটি আবার পাঠান। এর মানে সাধারণত অপেক্ষার সময় অপর্যাপ্ত ছিল এবং এর মানে এই নয় যে ঠিকানাটি ভুল।

ছোট রেসপন্সটি সফল হওয়ার পর, এটিকে আপনার নির্দিষ্ট করা একটি স্থানীয় ফাইল পড়তে বলুন। তারপর OmniProxy-এর অনুরোধ রেকর্ড খুলুন এবং রেকর্ডে দেখানো উৎস এবং মডেল আইডি নিশ্চিত করুন। শুধুমাত্র সংস্করণ কমান্ড বা ডক্টর থেকে আউটপুট আসার মানে এই নয় যে মডেল সংযোগটি সম্পূর্ণ কনফিগার করা হয়েছে।

ইনস্টলেশন

কমান্ডটি রেসপন্স করে

• সংস্করণ নম্বর প্রদর্শিত হয়
• ডক্টর কোনো বাধা রিপোর্ট করে না
• গেটওয়ে স্ট্যাটাস পাঠযোগ্য

কাজ

এটি একটি ছোট কাজ সম্পন্ন করেছে

• উদাহরণস্বরূপ, একটি স্থানীয় ফাইল পড়ুন
• রেসপন্সটি কোনো ত্রুটি নয়
• মডেল রেফারেন্সটি সঠিক

লগ

গেটওয়েতে দৃশ্যমান

• উৎস হলো OpenClaw
• মডেল আইডি মিলে যায়
• কী (key) রিপোজিটরিতে যোগ করা হয়নি

সাধারণ ত্রুটি

• খুঁজে পাওয়া যাচ্ছে না openclaw: npm গ্লোবাল বিন ডিরেক্টরিটি PATH-এ যোগ করুন, তারপর টার্মিনালটি পুনরায় খুলুন। যদি আপনি একটি নির্দিষ্ট ডিরেক্টরিতে ইনস্টল করে থাকেন, তবে সেই ডিরেক্টরির bin ফোল্ডার থেকে এক্সিকিউটেবল ফাইলটি চালান।
• node -v 24.16-এর নিচে: আপনাকে আগে পুরোনো সংস্করণটি আনইনস্টল করতে হবে না। ইনস্টলেশন স্ক্রিপ্ট দ্বারা প্রস্তুত করা Node সংস্করণটি পরীক্ষা করুন, অথবা ইনস্টলেশন পৃষ্ঠায় বর্ণিত 24.16+ বা 26.1+ ব্যবহার করুন। Node 26 প্রস্তাবিত।
• মডেলটি দেখা যাচ্ছে না: মডেলটিকে অবশ্যই models অ্যারের অধীনে models.providers অন্তর্ভুক্ত থাকতে হবে এবং অন্তত একই idথাকতে হবে। শুধুমাত্র agents.defaults.models সেট করা নিজে থেকে কোনো নতুন মডেল রেজিস্টার করে না।
• একটি 400 রেসপন্স ডেভেলপার রোলের কথা উল্লেখ করে: যখন অ্যাড্রেস হোস্ট api.openai.comনয়, তখন ডিফল্ট রাখুন এবং supportsDeveloperRole কে true সেট করবেন না। এমনকি যদি এটি true সেট করা থাকে, তবুও এটি ওভাররাইড করা হবে।
• এটি দ্রুত টাইম আউট হয়: ঠিকানা পরিবর্তন করার আগে --timeout কে ৩০০ সেকেন্ডের বেশি বাড়ান।
• নির্বাচন করার পর টুল কল ব্যর্থ হয় gpt-6-luna: এটি চ্যাট কমপ্লিশন সাপোর্ট করে; চ্যাট কমপ্লিশনে ফাংশন কলিং শুধুমাত্র তখনই সাপোর্ট করে যখন reasoning_effort হলো none। যদি তালিকার আইডি এর থেকে আলাদা হয়, তবে তালিকায় দেখানো আইডি ব্যবহার করুন।
• ঠিকানায় পৌঁছানো যাচ্ছে না: নিশ্চিত করুন যে OmniProxy চলছে, baseUrl শেষ হচ্ছে /v1দিয়ে, এবং কনফিগারেশনে লেখা ঠিকানাটি অ্যাক্সেসযোগ্য। অন্যান্য প্রাইভেট-নেটওয়ার্ক ঠিকানা আলাদাভাবে অনুমতি দিতে হবে।
• কনফিগারেশনের পরেও অনুরোধগুলো অন্য ঠিকানায় যাচ্ছে: পরীক্ষা করুন যে সেই এজেন্টের models.json একটি ভিন্ন baseUrl ধারণ করে কিনা।

অফিসিয়াল রেফারেন্স

ইনস্টলেশন ধাপের জন্য, দেখুন OpenClaw install। কাস্টম প্রোভাইডার কনফিগারেশনের জন্য, দেখুন Custom providers এবং configuration fields। উদাহরণে ব্যবহৃত মডেল আইডির জন্য, তুলনা করুন Claude model overview এবং GPT-6 Luna.

আপনার নিজস্ব OmniProxy কনফিগারেশন থেকে প্রতিটি প্লেসহোল্ডার মান দিয়ে প্রতিস্থাপন করুন। কখনোই একটি বাস্তব কি প্রকাশ করবেন না।

একটি সংরক্ষিত ফলাফল বা HTTP 200 নিজে থেকেই এজেন্টের পূর্ণ সামঞ্জস্যতা প্রমাণ করে না। OmniProxy-এর কল লগে উৎস এবং মডেল পরীক্ষা করুন।

অফিশিয়াল উৎস · OpenClaw ↗