نصب

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

• Node 24 (پیشنهادی) یا Node 22.19+ - اسکریپت نصب این مورد را به‌صورت خودکار مدیریت می‌کند
• macOS، Linux، یا Windows - کاربران Windows می‌توانند با برنامه بومی Windows Hub، نصب‌کننده PowerShell برای CLI، یا یک 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-checkout را در همان جریان پیشوندی. مرجع کامل: جزئیات داخلی نصب‌کننده.

قبلا نصب کرده‌اید؟ با 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

از سورس

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

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

یا link را رد کنید و از داخل repo از pnpm openclaw ... استفاده کنید. برای جریان‌های کاری کامل توسعه، راه‌اندازی را ببینید.

نصب از checkout شاخه 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، با fallback به آیتم ورود پوشه Startup برای هر کاربر اگر ایجاد task رد شود

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

OpenClaw را روی یک سرور ابری یا VPS مستقر کنید:

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

عیب‌یابی: openclaw پیدا نشد

اگر نصب موفق بود اما openclaw در ترمینال شما پیدا نمی‌شود:

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?

اگر $(npm prefix -g)/bin در $PATH شما نیست، آن را به فایل راه‌اندازی shell خود اضافه کنید (~/.zshrc یا ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

سپس یک ترمینال جدید باز کنید. برای جزئیات بیشتر راه‌اندازی Node را ببینید.