Skip to main content

التثبيت

هل تابعت بالفعل بدء؟ هل اتبعت بالفعل بدء الاستخدام؟ أنت جاهز — هذه الصفحة مخصّصة لطرق التثبيت البديلة، والتعليمات الخاصة بالمنصّات، وأعمال الصيانة.

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

على Windows، نوصي بشدّة بتشغيل OpenClaw ضمن WSL2.

طرق التثبيت

يُعد برنامج التثبيت النصي الطريقة الموصى بها لتثبيت OpenClaw. فهو يتولّى اكتشاف Node وتثبيته والتهيئة الأولية في خطوة واحدة.

Installer script

يقوم بتنزيل CLI وتثبيته بشكل عام عبر npm، ثم تشغيل معالج التهيئة الأولية.
إذا كان لديك بالفعل Node 22+ وتفضّل إدارة التثبيت بنفسك:
للمساهمين أو لأي شخص يرغب في التشغيل من نسخة محلية.

طرق تثبيت أخرى

Docker

عمليات نشر مُحاوَاة بالحاويات أو دون واجهة.

Podman

حاوية Rootless: شغّل setup-podman.sh مرة واحدة، ثم نصّ الإطلاق.

Nix

تثبيت تصريحي عبر Nix.

Ansible

توفير الأسطول الآلي.

Bun

استخدام CLI فقط عبر بيئة Bun.

بعد التثبيت

تحقّق من أن كل شيء يعمل كما ينبغي:
إذا كنت بحاجة إلى مسارات تشغيل مخصّصة، استخدم:
  • OPENCLAW_HOME لمسارات داخلية معتمدة على دليل المنزل
  • OPENCLAW_STATE_DIR لموقع الحالة القابلة للتغيير
  • OPENCLAW_CONFIG_PATH لموقع ملف الإعدادات
راجع Environment vars لمعرفة الأولوية وكامل التفاصيل.

استكشاف الأخطاء وإصلاحها: openclaw غير موجود

تشخيص سريع:
إذا لم يكن $(npm prefix -g)/bin (macOS/Linux) أو $(npm prefix -g) (Windows) موجودًا ضمن $PATH، فلن يتمكّن الصدَف لديك من العثور على ثنائيات npm العامة (بما في ذلك openclaw).الإصلاح — أضِفه إلى ملف بدء تشغيل الصدَف لديك (~/.zshrc أو ~/.bashrc):
على Windows، أضِف ناتج npm prefix -g إلى PATH.ثم افتح طرفية جديدة (أو rehash في zsh / hash -r في bash).

التحديث / إلغاء التثبيت

Updating

حافظ على تحديث OpenClaw.

Migrating

الانتقال إلى جهاز جديد.

Uninstall

إزالة OpenClaw بالكامل.