كيفية تثبيت OpenClaw

استخدم المثبت الرسمي وأكمل معالج الإعداد للحصول على أسرع وأكثر إعداد آمن.

إجابة مختصرة

Confirm system requirements (Node.js 22+, macOS or Linux or Windows via WSL2), run the official install script, then complete openclaw onboard to connect channels and models.

الخطوة 1: تحقق من المتطلبات أولاً

يعتمد OpenClaw على ميزات Node الحديثة، لذا يلزم Node.js 22 أو أحدث. على نظام Windows، المسار المدعوم هو WSL2. يعد التثبيت على إصدارات Node الأقدم هو السبب الأكثر شيوعًا للفشل.

الخطوة 2: استخدم سكريبت التثبيت الرسمي

الطريقة الموصى بها تقوم بتثبيت CLI وإعداد وقت التشغيل:

curl -fsSL https://openclaw.bot/install.sh | bash
openclaw onboard --install-daemon

الخطوة 3: أكمل الإعداد

يقوم المعالج بإرشادك خلال عملية إقران قناة مراسلة، واختيار مزود نموذج، وتمكين المهارات. هذا هو المكان الذي تحدد فيه الأذونات الأولية وتؤكد ما يمكن لـ OpenClaw الوصول إليه.

أوامر مفيدة بعد التثبيت

Use openclaw doctor to validate dependencies, openclaw status or openclaw health to check the gateway, and openclaw update to stay current.

تحقق من التثبيت قبل الاستخدام الإنتاجي

بعد الإعداد، قم بتشغيل مهمة اختبار صغيرة تستخدم مهارة منخفضة المخاطر، مثل إنشاء ملف في مجلد مؤقت أو تلخيص ملف نصي محلي. هذا يؤكد أن قناتك ونموذجك ومهاراتك متصلة بشكل صحيح. إذا كنت تقوم بالنشر على خادم، فتحقق من أن المنافذ المطلوبة فقط مفتوحة وأن إقران المسؤول مفروض.

عيوب التثبيت الشائعة

Most failures come from an outdated Node version, missing build tools, or running the script under the wrong user account. Another frequent issue is partial installs caused by network errors during package download. If the CLI behaves inconsistently, re-run the install script and check logs with openclaw doctor .

تذكيرات أمنية

لا تعرض نقاط نهاية المسؤول للإنترنت العام، وتجنب تثبيت المهارات غير الموثوق بها. إذا كنت تشغل OpenClaw على خادم، فقم بتأمين المنافذ واستخدم وصول الحد الأدنى من الامتيازات.

المراجع الرسمية

For exact instructions, see the official install and wizard pages: Install and Onboard .