​

التثبيت

​

الموصى به: script التثبيت

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

​

متطلبات النظام

• Node 24 ‏(موصى به) أو Node 22.14+ — يتولى script التثبيت ذلك تلقائيًا
• macOS أو Linux أو Windows — يدعم كلًا من Windows الأصلي وWSL2؛ ويكون WSL2 أكثر استقرارًا. راجع Windows.
• يلزم pnpm فقط إذا كنت ستبني من المصدر

​

طرق التثبيت البديلة

​

مثبّت local prefix ‏(install-cli.sh)

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

​

npm أو pnpm أو bun

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

​

من المصدر

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

​

التثبيت من GitHub main

npm install -g github:openclaw/openclaw#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 folder إذا تم رفض إنشاء المهمة

​

الاستضافة والنشر

​

التحديث أو الترحيل أو إلغاء التثبيت

​

استكشاف الأخطاء وإصلاحها: تعذر العثور على openclaw

node -v           # هل Node مثبت؟
npm prefix -g     # أين توجد الحزم العامة؟
echo "$PATH"      # هل يوجد دليل bin العام في PATH؟

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