نصب

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

• Node 22.19+، 23.11+، یا 24+ - 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 ... را درون مخزن اجرا کنید. برای گردش‌کارهای کامل توسعه، به پیکربندی مراجعه کنید.

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

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

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

تأیید نصب

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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

• 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 installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?