Windows

يشحن OpenClaw تطبيقًا مرافقًا أصليًا باسم Windows Hub مع دعم CLI على Windows. استخدم Windows Hub عندما تريد تطبيق سطح مكتب يتضمن الإعداد، وحالة علبة النظام، والدردشة، وتشخيصات مركز الأوامر، وقدرات عقدة Windows. استخدم مثبّت PowerShell عندما تريد CLI/Gateway مباشرة. استخدم WSL2 عندما تريد بيئة تشغيل Gateway الأكثر توافقًا مع Linux.

موصى به: Windows Hub

Windows Hub هو التطبيق المرافق الأصلي المبني بـ WinUI لنظامي Windows 10 20H2+ وWindows 11. يُثبَّت من دون امتيازات مسؤول، ويُنشر بمثبّتات x64 وARM64 موقّعة ضمن إصدارات OpenClaw.

نزّل أحدث مثبّت مستقر من صفحة إصدارات OpenClaw:

• OpenClawCompanion-Setup-x64.exe
• OpenClawCompanion-Setup-arm64.exe
• Checksums

إذا أعاد أحد روابط التنزيل أعلاه خطأ 404، فزر صفحة الإصدارات وابحث عن أصول OpenClawCompanion-Setup-* في أحدث إصدار.

بعد التثبيت، شغّل OpenClaw Companion من قائمة البدء أو من علبة النظام. يضيف المثبّت أيضًا اختصارات لإعداد Gateway، والدردشة، والإعدادات، والتحقق من التحديثات، وإلغاء التثبيت.

ما يتضمنه Windows Hub

• حالة علبة النظام والتشغيل عند تسجيل الدخول
• إعداد أول تشغيل لـ Gateway ضمن WSL مملوك للتطبيق ومحلي
• إعدادات اتصال لـ Gateways المحلية والبعيدة والممرّرة عبر SSH
• نافذة دردشة أصلية مع وصول إلى واجهة التحكم في المتصفح
• تشخيصات مركز الأوامر للجلسات، والاستخدام، والقنوات، والعقد، والإقران، و أوامر الإصلاح
• وضع عقدة Windows للوحات يتحكم بها الوكيل، والشاشة، والكاميرا، والإشعارات، وحالة الجهاز، وتحويل النص إلى كلام، وتحويل الكلام إلى نص، وsystem.run المتحكَّم به
• وضع خادم MCP محلي لعملاء MCP مثل Claude Desktop وClaude Code و Cursor

التشغيل الأول

عند التشغيل الأول، يفتح Windows Hub الإعداد عندما لا توجد Gateway محفوظة وقابلة للاستخدام. أسرع مسار هو الإعداد محليًا، والذي يجهّز توزيعة WSL OpenClawGateway مملوكة للتطبيق، ويثبّت Gateway داخلها، ويقرن التطبيق. لا يصدّر هذا توزيعة Ubuntu الحالية لديك ولا يعدّلها.

اختر الإعداد المتقدم أو افتح تبويب الاتصالات عندما تكون لديك Gateway بالفعل. يمكنك الاتصال بـ:

• Gateway محلية على هذا الحاسوب
• Gateway ضمن WSL على هذا الحاسوب
• Gateway بعيدة عبر URL ورمز مميز أو رمز إعداد
• Gateway يمكن الوصول إليها عبر نفق SSH

عند انتهاء الإعداد، يتحول رمز علبة النظام إلى اللون الأخضر. افتح مركز الأوامر من علبة النظام لتأكيد الاتصال، والإقران، وحالة العقدة، وصحة القنوات.

وضع عقدة Windows

يمكن لـ Windows Hub التسجيل كعقدة OpenClaw من الدرجة الأولى. يمكن للوكيل بعد ذلك استخدام قدرات Windows الأصلية المعلنة عبر Gateway.

تشمل الأوامر الشائعة:

• canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
• screen.snapshot ومع الاشتراك الصريح، screen.record
• camera.list ومع الاشتراك الصريح، camera.snap, camera.clip
• system.notify, system.run, system.run.prepare, system.which
• location.get, device.info, device.status
• stt.transcribe, tts.speak

يتطلب وضع العقدة الإقران مع Gateway. إذا عرض التطبيق طلب إقران، فوافق عليه من مضيف Gateway:

openclaw devices listopenclaw devices approve <request-id>openclaw nodes status

لا يمرر Gateway إلا الأوامر التي تعلنها العقدة وتسمح بها سياسة الخادم. تتطلب الأوامر الحساسة للخصوصية مثل screen.record وcamera.snap و camera.clip اشتراكًا صريحًا عبر gateway.nodes.allowCommands.

وضع MCP المحلي

يمكن لـ Windows Hub إتاحة سجل القدرات الأصلية نفسه في Windows كخادم MCP محلي على local loopback. يكون هذا مفيدًا عندما تريد من عملاء MCP المحليين تشغيل قدرات Windows من دون Gateway قيد التشغيل.

فعّله في إعدادات Windows Hub ضمن قسم المطور/المتقدم. يعرض التطبيق نقطة نهاية local loopback ورمز الحامل بعد تفعيل الخادم.

مصفوفة الأوضاع:

CLI وGateway الأصليان على Windows

للاستخدام الموجّه للطرفية، ثبّت OpenClaw من PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

تحقق:

openclaw --versionopenclaw doctoropenclaw gateway status --json

تدفقات CLI وGateway الأصلية على Windows مدعومة وتستمر في التحسن. يستخدم بدء التشغيل المُدار مهام Windows المجدولة عندما تكون متاحة. تحتفظ المهمة بسكربت gateway.cmd القابل للقراءة في دليل حالة OpenClaw، لكنها تشغّله عبر غلاف WScript مُولَّد باسم gateway.vbs كي لا يفتح Gateway العامل في الخلفية نافذة وحدة تحكم مرئية. إذا رُفض إنشاء المهمة، يعود OpenClaw إلى عنصر تسجيل دخول في مجلد Startup لكل مستخدم.

لتثبيت خدمة Gateway:

openclaw gateway installopenclaw gateway status --json

إذا كنت تريد استخدام CLI فقط من دون خدمة Gateway مُدارة:

openclaw onboard --non-interactive --skip-healthopenclaw gateway run

WSL2 Gateway

يبقى WSL2 بيئة تشغيل Gateway الأكثر توافقًا مع Linux على Windows. يمكن لـ Windows Hub إعداد Gateway ضمن WSL مملوك للتطبيق لك، أو يمكنك التثبيت يدويًا داخل توزيعتك الخاصة.

الإعداد اليدوي:

wsl --install# Or pick a distro explicitly:wsl --list --onlinewsl --install -d Ubuntu-24.04

فعّل systemd داخل WSL:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

أعد تشغيل WSL من PowerShell:

wsl --shutdown

ثم ثبّت OpenClaw داخل WSL باستخدام البدء السريع الخاص بـ Linux:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw gateway status

بدء Gateway تلقائيًا قبل تسجيل الدخول إلى Windows

لإعدادات WSL بلا شاشة، تأكد من تشغيل سلسلة الإقلاع كاملة حتى عندما لا يسجل أحد الدخول إلى Windows.

داخل WSL:

sudo apt-get install -y dbus-x11sudo loginctl enable-linger "$(whoami)"openclaw gateway install

في PowerShell كمسؤول:

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

استبدل Ubuntu باسم توزيعتك من:

wsl --list --verbose

ملاحظة: تغييران عن الوصفات الأقدم:

• dbus-launch true بدلًا من /bin/true — في WSL ≥ 2.6.1.0، يتسبب تراجع (microsoft/WSL #13416) في إنهاء التوزيعة خمولًا بعد 15-20 ثانية من خروج آخر عميل، حتى مع تفعيل linger. يحافظ dbus-launch true على عملية فرعية من init حية كحل بديل (نقاش المجتمع، microsoft/WSL #9245).
• /ru "$env:USERNAME" بدلًا من /ru SYSTEM — توزيعات WSL لكل مستخدم (الإعداد الافتراضي) غير مرئية لحساب SYSTEM؛ تبدو المهمة كأنها تعمل لكن التوزيعة لا تبدأ أبدًا. تشغيلها بحسابك يتجنب ذلك. سيطلب Windows كلمة مرورك عند إنشاء المهمة.

بعد إعادة التشغيل، تحقق من WSL:

systemctl --user is-enabled openclaw-gateway.servicesystemctl --user status openclaw-gateway.service --no-pager

إتاحة خدمات WSL عبر LAN

لدى WSL شبكته الافتراضية الخاصة. إذا كان على جهاز آخر الوصول إلى خدمة داخل WSL، فمرّر منفذ Windows إلى عنوان IP الحالي لـ WSL. يمكن أن يتغير عنوان IP الخاص بـ WSL بعد إعادة التشغيل، لذا حدّث قاعدة التمرير عند الحاجة.

مثال في PowerShell كمسؤول:

$Distro = "Ubuntu-24.04"$ListenPort = 2222$TargetPort = 22 $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]if (-not $WslIp) { throw "WSL IP not found." } netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `  connectaddress=$WslIp connectport=$TargetPort New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `  -Protocol TCP -LocalPort $ListenPort -Action Allow

ملاحظات:

• يستهدف SSH من جهاز آخر عنوان IP لمضيف Windows، على سبيل المثال ssh user@windows-host -p 2222.
• يجب أن تشير العقد البعيدة إلى URL يمكن الوصول إليه لـ Gateway، وليس 127.0.0.1.
• استخدم listenaddress=0.0.0.0 للوصول عبر LAN. استخدم 127.0.0.1 للوصول المحلي فقط.

استكشاف الأخطاء وإصلاحها

لا يظهر رمز علبة النظام

تحقق من مدير المهام بحثًا عن OpenClaw.Tray.WinUI.exe. إذا كان يعمل، فافتح منطقة رموز علبة النظام المخفية وثبّته. إذا لم يكن يعمل، فشغّل OpenClaw Companion من قائمة البدء.

فشل الإعداد المحلي

افتح سجل الإعداد من Windows Hub أو افحص:

notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

الأسباب الشائعة هي تعطيل WSL، أو حظر الافتراضية، أو حالة WSL قديمة مملوكة للتطبيق، أو فشل في الشبكة أثناء تثبيت حزمة Gateway.

يقول التطبيق إن الإقران مطلوب

وافق على طلب المشغّل أو العقدة من Gateway:

openclaw devices listopenclaw devices approve <request-id>

إذا كان لدى الجهاز رمز مميز مسبقًا، فأعد الاتصال من تبويب الاتصالات بعد الموافقة.

لا يمكن لدردشة الويب الوصول إلى Gateway بعيدة

تحتاج دردشة الويب البعيدة إلى HTTPS أو localhost. للشهادات الموقعة ذاتيًا، ثق بالشهادة في Windows، أو استخدم نفق SSH إلى URL على localhost.

فشل أوامر screen.snapshot أو الكاميرا أو الصوت

أكد أذونات Windows للكاميرا، والميكروفون، والتقاط الشاشة، و الإشعارات. تعلن التثبيتات المعبأة القدرات المحمية، لكن Windows قد يظل يطلب الإذن في المرة الأولى التي يستخدمها فيها أمر.

فشل الاتصال بـ Git أو GitHub

تحظر بعض الشبكات أو تخنق HTTPS إلى GitHub. إذا فشل git clone أو gh auth login، فجرّب شبكة أخرى، أو VPN، أو وكيل HTTP/HTTPS.

لمصادقة gh المعتمدة على الرمز المميز في الجلسة الحالية:

$env:GH_TOKEN="<your-token>"gh auth statusgh auth setup-git

لا تلتزم الرموز المميزة أبدًا ولا تلصقها في القضايا أو طلبات السحب.

ذات صلة

• نظرة عامة على التثبيت
• إعداد Node.js
• العقد
• واجهة التحكم
• تهيئة Gateway