ইনস্টল গাইড

শূন্য থেকে OpenClaw ইনস্টল করা খুবই সহজ! নিচের ধাপগুলো অনুসরণ করুন, মাত্র ৫-১০ মিনিটেই হয়ে যাবে। চিন্তা করবেন না, প্রতিটা ধাপ বুঝিয়ে দেওয়া হবে।

📋 সিস্টেম প্রয়োজনীয়তা

ইনস্টল শুরু করার আগে দেখে নিন আপনার কম্পিউটার এই বেসিক শর্তগুলো পূরণ করে:

Node.js 22 বা তার উপরে — OpenClaw চালানোর বেসিক এনভায়রনমেন্ট (চিন্তা নেই, ইনস্টল স্ক্রিপ্ট নিজেই চেক করবে)
অপারেটিং সিস্টেম — macOS, Linux, বা Windows (WSL2 লাগবে)
মেমরি — কমপক্ষে 2GB ফ্রি RAM
ডিস্ক স্পেস — কমপক্ষে 500MB ফ্রি
ইন্টারনেট — ডাউনলোড এবং AI মডেল API কলের জন্য দরকার

ℹ️ Node.js কী? সহজ ভাষায়, Node.js হলো একটা "অনুবাদক" যেটা আপনার কম্পিউটারকে JavaScript-এ লেখা প্রোগ্রাম চালাতে দেয়। OpenClaw JavaScript-এ লেখা, তাই Node.js লাগে। আপনাকে JavaScript শিখতে হবে না, শুধু Node.js ইনস্টল করলেই হবে।

ℹ️ WSL2 কী? Windows ব্যবহারকারীরা মনোযোগ দিন: OpenClaw সরাসরি Windows-এ চলে না, WSL2 (Windows Subsystem for Linux 2) লাগে — এটা Windows-এর ভেতরে একটা ছোট Linux সিস্টেমের মতো। Windows ব্যবহার করলে ইনস্টল স্ক্রিপ্ট নিজেই এটা সেটআপ করে দেবে।

🌟 পদ্ধতি ১: ওয়ান-ক্লিক ইনস্টল স্ক্রিপ্ট (নতুনদের জন্য সেরা!)

এটা সবচেয়ে সহজ পদ্ধতি। টার্মিনালে একটা লাইন কপি-পেস্ট করুন, স্ক্রিপ্ট সব নিজেই করে দেবে। সত্যিই খুব সহজ!

💡 "টার্মিনাল" কী? টার্মিনাল হলো একটা উইন্ডো যেখানে আপনি টেক্সট কমান্ড টাইপ করতে পারেন। macOS-এ এটাকে "Terminal" বলে, Windows-এ "PowerShell" বলে। কম্পিউটারে "Terminal" সার্চ করে খুলতে পারেন।

টার্মিনাল খুলুন

Command + Space চাপুন, "Terminal" টাইপ করুন, তারপর Enter চাপুন। একটা কালো (বা সাদা) কমান্ড লাইন উইন্ডো খুলবে।

ইনস্টল কমান্ড কপি-পেস্ট করুন

নিচের কমান্ডটা কপি করুন, টার্মিনালে পেস্ট করুন, তারপর Enter চাপুন:

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

এই কমান্ড যা করবে:

আপনার কম্পিউটারে Node.js আছে কিনা চেক করবে, না থাকলে নিজেই ইনস্টল করবে
OpenClaw-এর লেটেস্ট ভার্সন ডাউনলোড ও ইনস্টল করবে
সেটআপ উইজার্ড (onboarding) চালাবে যেটা বেসিক সেটিংসে সাহায্য করবে

ইনস্টল শেষ হওয়ার জন্য অপেক্ষা করুন

ইনস্টলেশনে প্রায় ২-৫ মিনিট লাগবে, আপনার ইন্টারনেট স্পিডের উপর নির্ভর করে। টার্মিনালে অনেক টেক্সট স্ক্রল হবে — এটা স্বাভাবিক, ঘাবড়াবেন না! ইনস্টল শেষ হলে সেটআপ উইজার্ড নিজেই শুরু হবে।

টার্মিনাল খুলুন

Linux-এ Ctrl + Alt + T চেপে টার্মিনাল খুলতে পারেন, অথবা অ্যাপ মেনুতে "Terminal" সার্চ করুন।

ইনস্টল কমান্ড কপি-পেস্ট করুন

macOS-এর মতোই, নিচের কমান্ড কপি করুন, টার্মিনালে পেস্ট করুন, Enter চাপুন:

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

স্ক্রিপ্ট নিজেই Node.js চেক করবে, OpenClaw ডাউনলোড ও ইনস্টল করবে, সেটআপ উইজার্ড চালাবে।

ইনস্টল শেষ হওয়ার জন্য অপেক্ষা করুন

কয়েক মিনিট অপেক্ষা করুন, সেটআপ উইজার্ডের প্রম্পট দেখলে বুঝবেন ইনস্টল সফল!

PowerShell খুলুন (অ্যাডমিনিস্ট্রেটর হিসেবে)

Start মেনুতে "PowerShell" সার্চ করুন, ডান ক্লিক করুন, "Run as Administrator" সিলেক্ট করুন। এই ধাপটা জরুরি কারণ ইনস্টলের জন্য অ্যাডমিন পারমিশন লাগে।

ইনস্টল কমান্ড কপি-পেস্ট করুন

Windows ব্যবহারকারীদের জন্য এই বিশেষ কমান্ড:

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

এই স্ক্রিপ্ট নিজেই যা করবে:

WSL2 চেক ও সেটআপ করবে (আগে থেকে না থাকলে)
Node.js ইনস্টল করবে
OpenClaw ডাউনলোড ও ইনস্টল করবে
সেটআপ উইজার্ড চালাবে

ইনস্টল শেষ হওয়ার জন্য অপেক্ষা করুন

Windows-এ ইনস্টলেশন একটু বেশি সময় নিতে পারে (WSL2 ইনস্টল করতে হতে পারে), প্রায় ৫-১০ মিনিট। শেষ হলে সেটআপ উইজার্ড নিজেই শুরু হবে।

⚠️ Windows ব্যবহারকারীরা মনোযোগ দিন: WSL2 ইনস্টলের পর কম্পিউটার রিস্টার্ট করতে হতে পারে। স্ক্রিপ্ট রিস্টার্ট করতে বললে আগে রিস্টার্ট করুন, তারপর আবার ইনস্টল কমান্ড চালান।

📦 পদ্ধতি ২: npm দিয়ে ইনস্টল

যদি আপনি Node.js এবং npm (Node.js-এর প্যাকেজ ম্যানেজার) চেনেন, তাহলে এই পদ্ধতি ব্যবহার করতে পারেন।

Node.js ইনস্টল আছে কিনা চেক করুন

টার্মিনাল খুলে এই কমান্ড টাইপ করুন:

node --version

v22.x.x বা তার বেশি দেখালে আপনি প্রস্তুত। না থাকলে nodejs.org থেকে লেটেস্ট ভার্সন ডাউনলোড করুন।

npm দিয়ে OpenClaw গ্লোবালি ইনস্টল করুন

টার্মিনালে চালান:

npm install -g openclaw@latest

কমান্ডের মানে:

npm install — npm দিয়ে সফটওয়্যার ইনস্টল করো
-g — গ্লোবাল ইনস্টল, যেকোনো জায়গা থেকে openclaw কমান্ড চালানো যাবে
openclaw@latest — OpenClaw-এর লেটেস্ট ভার্সন

সেটআপ চালান ও ব্যাকগ্রাউন্ড সার্ভিস রেজিস্টার করুন

ইনস্টল শেষে চালান:

openclaw onboard --install-daemon

এই কমান্ড দুটো কাজ করে:

onboard — সেটআপ উইজার্ড শুরু করে (AI মডেল বাছাই, API key দেওয়া ইত্যাদি)
--install-daemon — OpenClaw-কে ব্যাকগ্রাউন্ড সার্ভিস হিসেবে রেজিস্টার করে, কম্পিউটার চালু হলেই নিজে থেকে শুরু হবে

💡 Daemon কী? সহজ কথায়: এমন একটা প্রোগ্রাম যেটা ব্যাকগ্রাউন্ডে চুপচাপ চলতে থাকে, আপনি এর উইন্ডো দেখতে পান না কিন্তু এটা কাজ করতে থাকে। --install-daemon দিলে OpenClaw ব্যাকগ্রাউন্ডে সবসময় আপনার মেসেজের অপেক্ষায় থাকবে।

🐳 পদ্ধতি ৩: Docker দিয়ে ইনস্টল

Docker ব্যবহার করলে বা OpenClaw-কে সম্পূর্ণ আলাদা পরিবেশে চালাতে চাইলে এই পদ্ধতি।

ℹ️ Docker কী? Docker একটা "ভার্চুয়াল বাক্স"-এর মতো, সফটওয়্যার এর ভেতরে রেখে চালাতে পারেন। সমস্যা হলেও কম্পিউটারে প্রভাব পড়ে না। Docker না জানলে পদ্ধতি ১ বা ২ ব্যবহার করুন।

Docker ইনস্টল আছে কিনা দেখুন

না থাকলে docker.com থেকে Docker Desktop ডাউনলোড করুন।

OpenClaw Docker কন্টেইনার চালান

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  ghcr.io/openclaw/openclaw:latest

এটা OpenClaw-এর Docker ইমেজ ডাউনলোড করে কন্টেইনার চালু করবে। -v প্যারামিটার কনফিগ ফাইল আপনার কম্পিউটারে ম্যাপ করে, ডেটা হারাবে না।

✅ ইনস্টলের পর যাচাই

ইনস্টল হয়ে গেছে? এখন দেখি সব ঠিক আছে কিনা:

হেলথ চেক চালান

openclaw doctor

এটা OpenClaw-এর "মেডিকেল চেকআপ"। সব ঠিক থাকলে সবুজ টিক চিহ্ন দেখাবে।

স্ট্যাটাস চেক করুন

openclaw status

"running" দেখালে সব বাহ!

ওয়েব কন্ট্রোল প্যানেল খুলুন

openclaw dashboard

ব্রাউজারে OpenClaw-এর ওয়েব কন্ট্রোল প্যানেল খুলবে:

http://127.0.0.1:18789/

🎉 তিনটা কমান্ডই কোনো এরর ছাড়া চললে অভিনন্দন! OpenClaw সফলভাবে ইনস্টল হয়েছে! এবার কুইক স্টার্ট সেকশনে যান।

🛠️ ইনস্টলে সাধারণ সমস্যা

সমস্যা হয়েছে? ভয় পাবেন না! নিচে সবচেয়ে সাধারণ সমস্যা ও সমাধান দেওয়া আছে:

সমস্যা ১: কমান্ড পাওয়া যাচ্ছে না (command not found: openclaw)

সাধারণত PATH এনভায়রনমেন্ট ভ্যারিয়েবলের সমস্যা। সহজ কথায়, কম্পিউটার জানে না openclaw কোথায়।

সমাধান:

# openclaw কোথায় ইনস্টল আছে দেখুন
which openclaw || npm list -g openclaw

# bash ব্যবহার করলে
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh ব্যবহার করলে (macOS ডিফল্ট)
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

সমস্যা ২: Node.js ভার্সন পুরনো

"Node.js v18 is not supported" দেখলে Node.js আপগ্রেড করতে হবে।

সমাধান:

# nvm দিয়ে Node.js ম্যানেজ করুন
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22
node --version

সমস্যা ৩: পোর্ট কনফ্লিক্ট (EADDRINUSE)

"EADDRINUSE: address already in use :::18789" দেখলে পোর্ট আগে থেকে ব্যবহৃত।

সমাধান:

lsof -i :18789
openclaw stop
openclaw start

সমস্যা ৪: পারমিশন এরর (EACCES)

সমাধান:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest

⚠️ sudo npm install -g কখনো ব্যবহার করবেন না! sudo দিলে পারমিশন ঠিক হবে, কিন্তু সিকিউরিটি সমস্যা হতে পারে।

সমস্যা ৫: নেটওয়ার্ক টাইমআউট

সমাধান:

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest