تثبيت OpenClaw وتهيئة OmniProxy

OpenClaw هو مساعد ذكاء اصطناعي يتم تثبيته على جهاز الكمبيوتر الخاص بك. يمكنك التحدث معه مباشرة عبر Telegram أو Discord أو WhatsApp أو Feishu دون الحاجة لإبقاء نافذة دردشة أخرى مفتوحة. تظل المحادثات والسجلات على هذا الجهاز، ويمكنه الاستمرار في تنفيذ الخطوات اللاحقة محلياً.

قبل البدء

يتطلب OpenClaw إصدار Node 24.16 أو أحدث. يمكنك أيضاً استخدام Node 26.1 أو أحدث، مع التوصية بـ Node 26. يوفر Node بيئة التشغيل المطلوبة لـ OpenClaw.

يمكن تثبيته على أنظمة macOS وLinux وWindows. إذا لم يكن الكمبيوتر يحتوي على إصدار مناسب من Node، فسيقوم نص التثبيت البرمجي بإعداد واحد تلقائياً: Node 26 على macOS وNode 24 LTS على Linux. مطلوب pnpm فقط عند بناء OpenClaw من المصدر.

إذا كان إصدار أقدم من Node مثبتاً بالفعل، فلا داعي لإلغاء تثبيته أولاً. أثناء الاختبار في 2026-10-09، كان إصدار Node الخاص بالنظام على هذا الكمبيوتر هو 24.2.0، وهو أقل من 24.16 المطلوب، وقام نص التثبيت غير التفاعلي بإعداد Node 24.21.0 تلقائياً.

هل تريد نافذة

رفيق سطح المكتب

• استخدم مثبت Hub على Windows
• استخدم GitHub DMG على macOS
• يمكن تثبيت البوابة المحلية (Gateway) أثناء الإعداد الأولي

موصى به رسمياً

نص التثبيت البرمجي

• macOS Linux WSL2
• استخدم PowerShell على Windows
• يمكنك إضافة --no-onboard

Node مثبت بالفعل

مدير الحزم

• npm pnpm أو bun
• ثم قم بتشغيل onboard
• راجع صفحة التثبيت لمعرفة إصدار Node

التثبيت والتشغيل لأول مرة

يمكنك تثبيت رفيق سطح المكتب مع نافذة رسومية، أو التثبيت مباشرة عبر سطر الأوامر. البوابة (Gateway) هي الخدمة المحلية المسؤولة عن استقبال الرسائل واستدعاء النماذج وإرجاع النتائج. يمكنك إعدادها عند فتح رفيق سطح المكتب لأول مرة.

إذا كنت تريد نافذة

• Windows: قم بتنزيل وتشغيل OpenClawCompanion-Setup-x64.exe أو OpenClawCompanion-Setup-arm64.exe. المثبت موقع ويتضمن الإعدادات وحالة علبة النظام والدردشة وأوضاع Node.
• macOS: قم بتنزيل OpenClaw .dmg من إصدارات OpenClaw على GitHub. يفضل استخدام dmg، على الرغم من أنه يمكنك أيضاً استخدام .zip. افتح OpenClaw.app بعد التثبيت. إذا كان هذا الإصدار لا يتضمن ملف macOS، فاتبع صفحة تطبيق macOS.

عند فتحه لأول مرة، يمكنك السماح لـ OpenClaw بإعداد البوابة (Gateway) على هذا الكمبيوتر أو الاتصال ببوابة بعيدة موجودة.

التثبيت عبر سطر الأوامر

بالنسبة لـ macOS وLinux وWSL2، استخدم:

curl -fsSL https://openclaw.ai/install.sh | bash

بالنسبة لـ Windows PowerShell، استخدم:

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

يكتشف النص البرمجي النظام الحالي، ويقوم بتثبيت Node عند الحاجة، ويقوم بتثبيت OpenClaw، ثم يبدأ عملية الإعداد الأولية. ترشدك عملية الإعداد خلال الإعداد لأول مرة.

إذا كنت لا ترغب في بدء الإعداد بعد، فاستخدم ما يلي بدلاً من ذلك على macOS وLinux وWSL2:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

على Windows، استخدم خيار -NoOnboard الرسمي:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

إذا كنت تدير Node بنفسك بالفعل، يمكنك أيضاً استخدام npm أو pnpm أو bun. مع npm 12 أو npm 11.16 وأحدث، قم بتشغيل:

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

بالنسبة لـ npm 11.15 والأقدم، قم بإزالة --allow-scripts=openclaw. عند استخدام pnpm، أضف --allow-build=openclaw. راجع صفحة التثبيت لمعرفة الاختلافات الدقيقة.

بعد التثبيت، قم بتشغيل هذه الأوامر الثلاثة بالترتيب:

openclaw --version
openclaw doctor
openclaw gateway status

يعرض openclaw --version الإصدار، ويتحقق openclaw doctor من مشكلات البيئة الشائعة، ويوضح openclaw gateway status ما إذا كانت البوابة (Gateway) تعمل. يكتمل التثبيت الأساسي فقط عندما تنتج الأوامر الثلاثة مخرجات طبيعية.

إذا أبلغ سطر الأوامر أنه لا يمكنه العثور على openclaw، فعادة ما يكون دليل npm الثنائي العام مفقوداً من PATH. PATH هي قائمة المواقع التي يبحث فيها سطر الأوامر عن البرامج. قارن مخرجات node -v وnpm prefix -g وecho "$PATH"، وأضف دليل bin المقابل إلى PATH، ثم أعد فتح سطر الأوامر.

إذا كان ~/.openclaw يحتوي بالفعل على تكوين قيد الاستخدام حالياً، فسيستخدم نص التثبيت الافتراضي هذا الدليل. لتثبيت نسخة منفصلة دون تغيير التكوين الحالي، قم بتشغيل النص البرمجي غير التفاعلي وحدد دليلاً جديداً:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix "$HOME/openclaw-omniproxy" --no-onboard

--no-onboard هو السلوك الافتراضي لهذا النص البرمجي. في 2026-10-09، قام هذا الأمر بتثبيت OpenClaw 2026.9.9. بعد التثبيت، قم بتشغيل الملف التنفيذي openclaw من مجلد bin الخاص بالدليل.

الحصول على قيم الاتصال من OmniProxy

تأكد أولاً من أن OmniProxy يعمل، ثم افتح قائمة النماذج الخاصة به وقم بإعداد القيم الثلاث التالية:

baseUrl: https://your-omniproxy-origin.example/v1
apiKey:  <YOUR_OMNIPROXY_API_KEY>
Model ID: copy the full value from the current OmniProxy model list

baseUrl هو العنوان الذي يرسل إليه OpenClaw طلبات النماذج، ويجب أن ينتهي بـ /v1. عند الاتصال بـ OmniProxy، استخدم openai-completions لـ api. قم بتغييره إلى openai-responses فقط إذا كان النموذج يعمل بالفعل من خلال /v1/responses.

معرف النموذج (Model ID) هو المعرف الكامل للنموذج في القائمة. انسخه تماماً كما هو موضح، بما في ذلك أي شرطات مائلة. الاسمان التاليان هما مجرد مراجع من وثائق المزود اعتباراً من 2026-10-09؛ لا تستخدمهما إذا لم يظهرا في القائمة: claude-sonnet-5-5، gpt-6-luna.

حتى إذا لم تقم البوابة بالتحقق من المفتاح، يجب أن يحتوي apiKey على قيمة. يمكنك استخدام سلسلة نصية نائبة تُستخدم فقط على هذا الكمبيوتر. لا تقم برفع مفتاح حقيقي إلى مستودع.

إدخال تكوين الأداة

يمكن فهم المزود (Provider) على أنه مجموعة من إعدادات الاتصال التي يستخدمها OpenClaw لتحديد موقع خدمة النموذج. هنا، تمت تسمية المزود بـ omniproxy.

قم بتشغيل الأمر التالي في سطر الأوامر، مع استبدال العنوان والمفتاح ومعرفي النموذج بقيمك الخاصة:

openclaw config set models.providers.omniproxy '{"baseUrl":"https://your-omniproxy-origin.example/v1","apiKey":"<YOUR_OMNIPROXY_API_KEY>","api":"openai-completions","models":[{"id":"claude-sonnet-5-5","name":"Claude Sonnet 5.5"},{"id":"gpt-6-luna","name":"GPT-6 Luna"}]}' --strict-json --merge

يكتب هذا الأمر المزود وقائمة النماذج في التكوين. لا تحتاج إلى إعادة تشغيل البوابة (Gateway) بعد نجاح الأمر.

بعد ذلك، حدد النموذج الافتراضي. يتكون مرجع النموذج من omniproxy/ متبوعاً بمعرف النموذج. حافظ على كل شرطة مائلة موجودة بالفعل في المعرف. إذا كان المعرف في قائمة النماذج أطول من الاسم المختصر أدناه، فاستخدم القيمة الكاملة من القائمة:

openclaw config set agents.defaults.model.primary '"omniproxy/claude-sonnet-5-5"' --strict-json

يمكن حذف reasoning وinput وcost وcontextWindow وmaxTokens. عندما لا يتم توفيرها، يتم التعامل مع نماذج النصوص باستخدام الإعدادات الافتراضية.

يمكنك أيضاً كتابة نفس الإعدادات مباشرة في ملف التكوين. في التكوين الرئيسي، يقع المزود تحت models.providers. يمكن أن يكون لكل وكيل (agent) أيضاً models.json خاص به؛ الوكيل هو مثيل مساعد يستقبل المهام فعلياً ويستدعي النماذج. يقع الملف في agent/models.json داخل دليل الوكيل المقابل تحت ~/.openclaw/agents/.

إذا كان models.json هذا يحتوي على baseUrl غير فارغ، فإنه يتجاوز العنوان في التكوين الرئيسي.

التحقق من التثبيت

ثلاثة أوامر

• openclaw --version
• openclaw doctor
• gateway status

التكوين

models.providers

• baseUrl ينتهي بـ /v1
• تعيين api إلى completions
• حدد معرف النموذج على الأقل

تحديد

provider/model

• استخدم هذا المرجع للأساسي
• يفضل استخدام متغير بيئة للمفتاح
• استخدم قائمة البوابة كمصدر للحقيقة

التحقق من مهمة حقيقية

أدخل دليل مشروع عادي وأرسل رسالة قصيرة جداً. استبدل مرجع النموذج في الأمر بمعرف النموذج الكامل الخاص بك:

openclaw agent --local --model omniproxy/claude-sonnet-5-5 --timeout 300 --message "Reply with one word."

يقوم --local بتشغيل مهمة الوكيل هذه محلياً، ويحدد --model النموذج المراد استخدامه لهذا التشغيل، ويضبط --timeout 300 الحد الأقصى لوقت الانتظار على 300 ثانية.

يجب أن تظهر استجابة نموذج حقيقية في سطر الأوامر. في 2026-10-09، تلقى OpenClaw 2026.9.9 استجابة باستخدام هذا الأمر. قد يستغرق الاستدعاء الأول دقيقة أو دقيقتين.

إذا ظهر الخطأ الأصلي Request timed out before a response was generated، فقم بزيادة --timeout وأرسل الطلب مرة أخرى. هذا يعني عادةً أن وقت الانتظار كان غير كافٍ ولا يشير بالضرورة إلى أن العنوان غير صحيح.

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

التثبيت

الأمر يستجيب

• يتم عرض رقم الإصدار
• الطبيب لا يبلغ عن أي حواجز
• حالة البوابة قابلة للقراءة

المهمة

أكملت مهمة صغيرة

• على سبيل المثال، قراءة ملف محلي
• الاستجابة ليست خطأ
• مرجع النموذج صحيح

السجلات

مرئية في البوابة

• المصدر هو OpenClaw
• معرف النموذج يطابق
• لم تتم إضافة المفتاح إلى المستودع

الأخطاء الشائعة

• لا يمكن العثور على openclaw: أضف دليل npm الثنائي العام إلى PATH، ثم أعد فتح سطر الأوامر. إذا قمت بالتثبيت في دليل محدد، فقم بتشغيل الملف التنفيذي من مجلد bin الخاص بذلك الدليل.
• node -v أقل من 24.16: لا تحتاج إلى إلغاء تثبيت الإصدار القديم أولاً. تحقق من إصدار Node الذي أعده نص التثبيت، أو استخدم 24.16+ أو 26.1+ كما هو موضح في صفحة التثبيت. يوصى بـ Node 26.
• النموذج لا يظهر: يجب تضمين النموذج في مصفوفة models تحت models.providers ويجب أن يكون له على الأقل نفس id. تعيين agents.defaults.models فقط لا يسجل نموذجاً جديداً بحد ذاته.
• استجابة 400 تذكر دور المطور: عندما لا يكون مضيف العنوان هو api.openai.com، احتفظ بالافتراضي ولا تضبط supportsDeveloperRole على true. حتى إذا تم ضبطه على true، فسيظل يتم تجاوزه.
• تنتهي المهلة بسرعة: قم بزيادة --timeout إلى أكثر من 300 ثانية قبل تغيير العنوان.
• تفشل استدعاءات الأدوات بعد تحديد gpt-6-luna: يدعم Chat Completions؛ يتم دعم استدعاء الوظائف في Chat Completions فقط عندما يكون reasoning_effort هو none. إذا كان المعرف في القائمة يختلف عن هذا، فاستخدم المعرف الموضح في القائمة.
• لا يمكن الوصول إلى العنوان: تأكد من أن OmniProxy يعمل، وأن baseUrl ينتهي بـ /v1، وأن العنوان المكتوب في التكوين يمكن الوصول إليه. يجب السماح بعناوين الشبكة الخاصة الأخرى بشكل منفصل.
• لا تزال الطلبات تذهب إلى عنوان آخر بعد التكوين: تحقق مما إذا كان models.json الخاص بذلك الوكيل يحتوي على baseUrl مختلف.

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

لخطوات التثبيت، راجع تثبيت OpenClaw. لتكوين المزود المخصص، راجع المزودون المخصصون وحقول التكوين. لمعرفات النماذج المستخدمة في الأمثلة، قارنها بـ نظرة عامة على نموذج Claude وGPT-6 Luna.

استبدل كل عنصر نائب بقيم من تكوين OmniProxy الخاص بك. لا تنشر أبدًا مفتاحًا حقيقيًا.

نتيجة محفوظة أو HTTP 200 وحدها لا تثبت توافق الوكيل الكامل. تحقق من المصدر والنموذج في سجل طلبات OmniProxy.

المصادر الرسمية · OpenClaw ↗