نصب

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

• 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 زیر یک پیشوند محلی مانند ~/.openclaw نگهداری شوند، بدون آنکه به نصب سراسری Node در سیستم وابسته باشید:

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 ... را از داخل مخزن به‌کار ببرید. برای جریان‌های کامل توسعه به راه‌اندازی مراجعه کنید.

نصب از نسخه شاخه اصلی 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 است؟