التثبيت
هل تابعت بالفعل بدء؟ هل اتبعت بالفعل بدء الاستخدام؟ أنت جاهز — هذه الصفحة مخصّصة لطرق التثبيت البديلة، والتعليمات الخاصة بالمنصّات، وأعمال الصيانة.متطلبات النظام
- Node 22+ (سيقوم برنامج التثبيت النصي بتثبيته إذا كان مفقودًا)
- macOS أو Linux أو Windows
pnpmفقط إذا قمت بالبناء من المصدر
على Windows، نوصي بشدّة بتشغيل OpenClaw ضمن WSL2.
طرق التثبيت
Installer script
Installer script
يقوم بتنزيل CLI وتثبيته بشكل عام عبر npm، ثم تشغيل معالج التهيئة الأولية.
npm / pnpm
npm / pnpm
إذا كان لديك بالفعل Node 22+ وتفضّل إدارة التثبيت بنفسك:
From source
From source
للمساهمين أو لأي شخص يرغب في التشغيل من نسخة محلية.
طرق تثبيت أخرى
Docker
عمليات نشر مُحاوَاة بالحاويات أو دون واجهة.
Podman
حاوية Rootless: شغّل
setup-podman.sh مرة واحدة، ثم نصّ الإطلاق.Nix
تثبيت تصريحي عبر Nix.
Ansible
توفير الأسطول الآلي.
Bun
استخدام CLI فقط عبر بيئة Bun.
بعد التثبيت
تحقّق من أن كل شيء يعمل كما ينبغي:OPENCLAW_HOMEلمسارات داخلية معتمدة على دليل المنزلOPENCLAW_STATE_DIRلموقع الحالة القابلة للتغييرOPENCLAW_CONFIG_PATHلموقع ملف الإعدادات
استكشاف الأخطاء وإصلاحها: openclaw غير موجود
PATH diagnosis and fix
PATH diagnosis and fix
تشخيص سريع:إذا لم يكن على Windows، أضِف ناتج
$(npm prefix -g)/bin (macOS/Linux) أو $(npm prefix -g) (Windows) موجودًا ضمن $PATH، فلن يتمكّن الصدَف لديك من العثور على ثنائيات npm العامة (بما في ذلك openclaw).الإصلاح — أضِفه إلى ملف بدء تشغيل الصدَف لديك (~/.zshrc أو ~/.bashrc):npm prefix -g إلى PATH.ثم افتح طرفية جديدة (أو rehash في zsh / hash -r في bash).التحديث / إلغاء التثبيت
Updating
حافظ على تحديث OpenClaw.
Migrating
الانتقال إلى جهاز جديد.
Uninstall
إزالة OpenClaw بالكامل.