نصب

نیازمندی‌های سیستم

• Node 22.22.3+، 24.15+ یا 25.9+ - Node 24 هدف پیش‌فرض است؛ اسکریپت نصب این مورد را به‌طور خودکار مدیریت می‌کند.
• macOS، Linux یا Windows - کاربران Windows می‌توانند با برنامه بومی Windows Hub، نصب‌کننده CLI در PowerShell یا یک Gateway در WSL2 شروع کنند. به Windows مراجعه کنید.
• pnpm فقط در صورت ساخت از کد منبع لازم است.

روش پیشنهادی: اسکریپت نصب

سریع‌ترین روش نصب. سیستم‌عامل را تشخیص می‌دهد، در صورت نیاز Node را نصب می‌کند، OpenClaw را نصب می‌کند و راه‌اندازی اولیه را آغاز می‌کند.

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

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

برای نصب بدون اجرای راه‌اندازی اولیه:

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

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

برای مشاهده همه پرچم‌ها و گزینه‌های CI/خودکارسازی، به جزئیات داخلی نصب‌کننده مراجعه کنید.

روش‌های جایگزین نصب

نصب‌کننده با پیشوند محلی (install-cli.sh)

وقتی می‌خواهید OpenClaw و Node بدون وابستگی به نصب سراسری Node، زیر یک پیشوند محلی مانند ~/.openclaw نگه‌داری شوند، از این روش استفاده کنید:

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

این روش به‌طور پیش‌فرض از نصب‌های npm و همچنین نصب از نسخه دریافت‌شده با git در همان جریان پیشوند پشتیبانی می‌کند. مرجع کامل: جزئیات داخلی نصب‌کننده.

قبلاً نصب کرده‌اید؟ با openclaw update --channel dev و openclaw update --channel stable بین نصب‌های بسته‌ای و git جابه‌جا شوید. به به‌روزرسانی مراجعه کنید.

npm، pnpm یا bun

اگر Node را خودتان مدیریت می‌کنید:

npm install -g openclaw@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

از کد منبع

برای مشارکت‌کنندگان یا هر کسی که می‌خواهد از یک نسخه محلی کد اجرا کند:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

همچنین می‌توانید پیوند را نادیده بگیرید و از داخل مخزن از pnpm openclaw ... استفاده کنید. برای مشاهده جریان‌های کاری کامل توسعه، به راه‌اندازی مراجعه کنید.

نصب از شاخه main در GitHub

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

کانتینرها و مدیران بسته

تأیید نصب

openclaw --version      # تأیید کنید CLI در دسترس استopenclaw doctor         # مشکلات پیکربندی را بررسی کنیدopenclaw gateway status # تأیید کنید Gateway در حال اجرا است

اگر پس از نصب، راه‌اندازی مدیریت‌شده می‌خواهید:

• macOS: ‏LaunchAgent از طریق openclaw onboard --install-daemon یا openclaw gateway install
• Linux/WSL2: سرویس کاربری systemd از طریق همان فرمان‌ها
• Windows بومی: ابتدا Scheduled Task و اگر ایجاد وظیفه رد شد، یک مورد ورود به سیستم در پوشه Startup مخصوص هر کاربر به‌عنوان روش جایگزین

میزبانی و استقرار

OpenClaw را روی یک سرور ابری یا VPS مستقر کنید. برای انتخاب کامل ارائه‌دهنده (DigitalOcean، Hetzner، Hostinger، Fly.io، GCP، Azure، Railway، Northflank، Oracle Cloud، Raspberry Pi و موارد دیگر) به سرور Linux مراجعه کنید، یا به‌صورت اعلانی روی Render مستقر کنید.

به‌روزرسانی، مهاجرت یا حذف نصب

عیب‌یابی: openclaw یافت نشد

تقریباً همیشه مشکل از PATH است: پوشه فایل‌های اجرایی سراسری npm در PATH پوسته شما قرار ندارد. برای راه‌حل کامل، از جمله مسیر Windows، به عیب‌یابی Node.js مراجعه کنید.

node -v           # آیا Node نصب شده است؟npm prefix -g     # بسته‌های سراسری کجا هستند؟echo "$PATH"      # آیا پوشه فایل‌های اجرایی سراسری در PATH است؟