Skip to main content

Windows (WSL2)

يُنصَح بتشغيل OpenClaw على Windows عبر WSL2 (يوصى بـ Ubuntu). يعمل كلٌّ من CLI وGateway داخل Linux، ما يحافظ على اتساق بيئة التشغيل ويجعل الأدوات أكثر توافقًا بكثير (Node/Bun/pnpm، ثنائيات Linux، Skills). قد يكون Windows الأصلي أكثر تعقيدًا. يوفّر WSL2 تجربة Linux كاملة — أمر واحد للتثبيت: wsl --install. التطبيقات المُرافِقة الأصلية لـ Windows مُخطَّط لها.

التثبيت (WSL2)

Gateway

تثبيت خدمة Gateway (CLI)

داخل WSL2:
أو:
أو:
اختر Gateway service عند المطالبة. الإصلاح/الترحيل:

متقدم: إتاحة خدمات WSL عبر الشبكة المحلية (portproxy)

يمتلك WSL شبكة افتراضية خاصة به. إذا احتاج جهاز آخر إلى الوصول إلى خدمة تعمل داخل WSL (SSH، خادم TTS محلي، أو Gateway)، فيجب إعادة توجيه منفذ Windows إلى عنوان IP الحالي لـ WSL. يتغيّر عنوان IP لـ WSL بعد إعادة التشغيل، لذا قد تحتاج إلى تحديث قاعدة إعادة التوجيه. مثال (PowerShell كمسؤول):
السماح للمنفذ عبر جدار حماية Windows (مرة واحدة):
تحديث portproxy بعد إعادة تشغيل WSL:
ملاحظات:
  • يستهدف SSH من جهاز آخر عنوان IP لمضيف Windows (مثال: ssh user@windows-host -p 2222).
  • يجب أن تشير العُقد البعيدة إلى عنوان URL لـ Gateway قابل للوصول (وليس 127.0.0.1)؛ استخدم openclaw status --all للتأكيد.
  • استخدم listenaddress=0.0.0.0 للوصول عبر الشبكة المحلية؛ و127.0.0.1 يبقيه محليًا فقط.
  • إذا رغبت في الأتمتة، سجّل مهمة مجدولة لتشغيل خطوة التحديث عند تسجيل الدخول.

تثبيت WSL2 خطوة بخطوة

1. تثبيت WSL2 + Ubuntu

افتح PowerShell (كمسؤول):
أعِد التشغيل إذا طلب Windows ذلك.

2. تمكين systemd (مطلوب لتثبيت Gateway)

في طرفية WSL لديك:
ثم من PowerShell:
أعِد فتح Ubuntu، ثم تحقّق:

3. تثبيت OpenClaw (داخل WSL)

اتبع مسار «بدء الاستخدام» الخاص بـ Linux داخل WSL:
الدليل الكامل: بدء الاستخدام

تطبيق Windows المُرافِق

لا يتوفر لدينا تطبيق مُرافِق لـ Windows بعد. نرحّب بالمساهمات إذا رغبت في المساعدة على تحقيق ذلك.