English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

نصب

Edit source

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

  • Node 24 (توصیه‌شده) یا Node 22.16+ - اسکریپت نصب این مورد را به‌صورت خودکار مدیریت می‌کند
  • macOS، Linux یا Windows - هم Windows بومی و هم WSL2 پشتیبانی می‌شوند؛ WSL2 پایدارتر است. Windows را ببینید.
  • pnpm فقط زمانی لازم است که از سورس بسازید

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

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

macOS / Linux / WSL2

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

Windows (PowerShell)

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

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

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

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

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

bash
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

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

pnpm

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

bun

bash
bun add -g openclaw@latestopenclaw onboard --install-daemon
Troubleshooting: sharp build errors (npm)

اگر sharp به‌دلیل یک libvips نصب‌شده به‌صورت سراسری شکست خورد:

bash
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

از سورس

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

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

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

نصب از GitHub main

bash
npm install -g github:openclaw/openclaw#main

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

Docker

استقرارهای کانتینری یا بدون رابط گرافیکی.
Podman

جایگزین کانتینر بدون root برای Docker.
Nix

نصب اعلانی از طریق Nix flake.
Ansible

آماده‌سازی خودکار ناوگان.
Bun

استفاده فقط از CLI از طریق زمان اجرای Bun.

بررسی نصب

bash
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 برای هر کاربر اگر ساخت task رد شود

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

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

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9mYS9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

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

Updating

OpenClaw را به‌روز نگه دارید.
Migrating

به یک ماشین جدید منتقل شوید.
Uninstall

OpenClaw را به‌طور کامل حذف کنید.

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

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

bash
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) اضافه کنید:

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

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

Was this useful?