نصب

# الزامات سیستم

• Node 24 (توصیه‌شده) یا Node 22.14+ - اسکریپت نصب‌کننده این مورد را به‌صورت خودکار مدیریت می‌کند
• macOS، Linux، یا Windows - هم Windows بومی و هم WSL2 پشتیبانی می‌شوند؛ 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@latest
openclaw onboard --install-daemon

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

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

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

# از سورس

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

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon

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

# نصب از GitHub main

npm install -g github:openclaw/openclaw#main

# کانتینرها و مدیران پکیج

# تایید نصب

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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 مستقر کنید:

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

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