Skip to content

طرق التثبيت البديلة: تطبيق سطح المكتب وDocker وnpm ​

في الدرس السابق شغّلنا المسار الرئيسي بالمثبّت الرسمي؛ لكن تنزيل OpenClaw وتثبيته لا يقتصر على ذلك المسار وحده — حاسوب العمل لا يسمح بتشغيل السكربتات، أو تريد تطبيق سطح مكتب مقيمًا في شريط المهام، أو تحتاج حاويات على الخادم، أو أنك تدير Node بنفسك ولا تريد من المثبّت أن يقوم بذلك نيابةً عنك. يشرح هذا الدرس المسارات البديلة الأربعة دفعة واحدة: تطبيق سطح المكتب وDocker والتثبيت المباشر عبر npm / pnpm / Bun والبناء من المصدر، وبعد 8 دقائق اختر مسارًا حسب سيناريوك. هذه الصفحة مبنية على v2026.10.9.

ماذا ستستطيع أن تفعل بعد التعلم ​

  • تنزيل وتثبيت Windows Hub (حزمة تثبيت موقّعة لـ x64 / ARM64) أو تطبيق شريط القوائم في macOS — طريقة تنزيل OpenClaw دون لمس الطرفية إطلاقًا
  • تشغيل Gateway داخل حاوية باستخدام Docker: سكربت setup يُتمم onboarding تلقائيًا، ويُفتح Control UI على منفذ 18789 في المتصفح
  • التثبيت المباشر لـ OpenClaw بمديري الحزم الثلاثة npm / pnpm / Bun، مع حفظ المعامل الإلزامي لكل منها
  • التثبيت بالبناء من المصدر وربط CLI openclaw بنسختك من المستودع
  • اختيار مسارك حسب السيناريو بجدول مقارنة واحد (إصدار سطح المكتب / Docker / تثبيت مباشر / المصدر)

مأزقك الحالي ​

  • حاسوب العمل لا يسمح بتشغيل سكربتات مثل curl | bash، وتريد حزمة تثبيت رسمية تنصّبها بنقرة مزدوجة
  • أنا مستخدم سطح مكتب Windows / macOS وأريد فقط تطبيقًا يقيم في شريط المهام أو شريط القوائم دون فتح الطرفية
  • أحتاج تشغيل 7×24 داخل حاويات على الخادم، أو أدير Node بنفسي — وميزة المثبّت تلك «التكملة التلقائية لـ Node» تصبح عائقًا

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

  • طريقة تنزيل وتثبيت OpenClaw بواجهة رسومية (تطبيق سطح المكتب)
  • بيئة Gateway معزولة وقابلة للحذف لا تلوّث جهازك المحلي (Docker)
  • التثبيت بمدير الحزم الخاص بك (npm / pnpm / Bun)، أو تشغيل أحدث فرع main مباشرة (البناء من المصدر)

ولا تريد:

  • العودة إلى الدرس السابق وسلوك المسار الرئيسي للمثبّت الرسمي curl | bash
  • تثبيت مجموعة Node runtime في نظامك (تطبيق سطح المكتب وDocker يأتيان مع runtime مدمج)

🎒 التحضير قبل البدء ​

  • أن تكون قد أكملت التثبيت: تشغيل OpenClaw في 5 دقائق — هذه الصفحة مسار بديل مكمّل لذلك الدرس؛ إذا كان المسار الرئيسي يعمل فلا داعي للتغيير
  • تهيئة البيئة حسب المسار الذي ستسلكه (انظر الجدول أدناه)
  • تجهيز «بطاقة مرور للنموذج»: أول تشغيل لتطبيق سطح المكتب، وsetup الخاص بـ Docker، وopenclaw onboard — كلها ستوجهك لتهيئة بيانات اعتماد النموذج (تسجيل الدخول عبر Claude Code / Codex CLI أو API Key، والتفاصيل في نظرة عامة على ربط النماذج)

متطلبات البيئة لكل مسار ​

المسارما يجب أن تكون لديك مسبقًا
تطبيق سطح المكتبيكفي أن تستطيع تنزيل حزمة التثبيت: Windows 10 20H2+ / Windows 11 (Hub)، وmacOS 26.2 (Tahoe)+ (تطبيق شريط القوائم)
DockerDocker Desktop أو Docker Engine + Docker Compose v2؛ وبناء الصورة محليًا يتطلب ذاكرة لا تقل عن 6 GB
التثبيت المباشر عبر npm / pnpm / BunNode 24.16.0+ (24.x) أو 26.1.0+ (يُنصح بـ 24.22.1+ / 26.12.1+)؛ ومسار Bun يتطلب Bun 1.4.4+
البناء من المصدرNode + Corepack (أو تثبيت pnpm 12 بنفسك) + git

⚠️ الشبكة داخل الصين

لا توفّر الوثائق الرسمية مرآة داخلية أو حلًّا لتسريع التنزيل، وهذا المقال لا يخمّن عناوين المرايا. إذا انتهت المهلة عند تنزيل حزمة تثبيت سطح المكتب من GitHub Releases أو سحب الصورة من GHCR، فتحقق من بيئة الشبكة أولًا ثم أعد المحاولة؛ وإذا استمر الفشل فاذهب إلى ماذا أفعل إذا لم ينجح التثبيت للمقارنة واستكشاف الأخطاء.

الفكرة الأساسية ​

جميع طرق التثبيت تثبّت الشيء نفسه: عملية Gateway واحدة + openclaw CLI + ملف إعداد واحد. الفرق بين المسارات الاحتياطية الأربعة يكمن فقط في «أين يعمل Gateway ومن يدير بيئة التشغيل»:

المسارأين يعمل Gatewayبيئة التشغيللمن يناسب
المثبّت الرسمي (المسار الرئيسي في الدرس السابق)خدمة في خلفية الجهاز المحلييثبّت Node تلقائيًا إذا كانت مفقودةلمن يريد أسرع طريق للعمل
تطبيق سطح المكتبيهيّئ App عند أول تشغيل Gateway محليًا، أو يتصل بـ Gateway بعيد موجود مسبقًايدير App بيئة التشغيل بنفسه ولا يعتمد على Node في النظاممستخدمو سطح المكتب الذين لا يريدون التعامل مع الطرفية
Docker / Podmanداخل الحاويةمضمّنة في الصورةبيئة معزولة، خوادم، بدون تثبيت محلي
تثبيت مباشر عبر npm / pnpm / Bunالجهاز المحلي (--install-daemon التثبيت كخدمة)تديره أنت بنفسكالمطورون، التثبيت بالجملة في CI
التجميع من المصدرالجهاز المحليتديره أنت بنفسك + pnpmالمساهمون، من يريد تشغيل أحدث main

المسارات الأربعة مستقلة عن بعضها، اختر مسارًا واحدًا حسب حالتك وسر فيه فقط؛ ترقيم الخطوات أدناه متسلسل لتسهيل الإحالة المتبادلة.

اتبع خطواتي ​

الخطوة 1: تنزيل نسخة سطح المكتب من OpenClaw — Windows Hub وتطبيق شريط القوائم في macOS ​

لماذا: تطبيق سطح المكتب هو ما أعدّته الجهة الرسمية لمستخدمي «عدم لمس الطرفية» كطريقة OpenClaw للتنزيل — تنزيل حزمة التثبيت مع إرشاد عبر واجهة رسومية. تطبيقا سطح المكتب الأصليان، Windows Hub وتطبيق شريط القوائم في macOS، كلاهما يستطيع تهيئة Gateway محلي أثناء إعداد أول تشغيل، أو الاتصال مباشرة بـ Gateway بعيد موجود مسبقًا.

مستخدمو Windows: Windows Hub (التوصية الرسمية) ​

على Windows توصي الجهة الرسمية أكثر всего بـ Windows Hub — تطبيق رفيق أصلي بواجهة WinUI، يدعم Windows 10 20H2+ وWindows 11، تثبيت بدون صلاحيات مسؤول، وحزم تثبيت x64 / ARM64 موقّعة جميعها:

بعد التنزيل والتثبيت، شغّل OpenClaw Companion من قائمة ابدأ أو من صينية النظام (يضيف المثبّت أيضًا اختصارات لـ Gateway Setup وChat وSettings والتحقق من التحديثات وإلغاء التثبيت). إذا لم يعثر على Gateway متاح عند أول تشغيل، سيدخل الإعداد تلقائيًا: أسرع طريق هو Set up locally — إذ ينشئ توزيعة OpenClawGateway WSL يديرها التطبيق بنفسه، ويثبّت Gateway فيها ويُكمل الاقتران دون المساس بتوزيعة Ubuntu الموجودة لديك. أما من لديه Gateway بالفعل فيختار Advanced setup، حيث يمكن الاتصال بـ Gateway على الجهاز المحلي / داخل WSL / عن بُعد (URL + token) أو عبر نفق SSH.

المفترض أن ترى: بعد اكتمال الإعداد يتحول أيقونة الصينية إلى اللون الأخضر؛ افتح Command Center من الصينية وسترى أن الاتصال والاقتران وحالة العقد وصحة القنوات كلها طبيعية.

💡 الرابط المباشر أصبح 404؟

دورة إصدارات Windows Hub مستقلة عن OpenClaw CLI وGateway. عندما تفشل الروابط المباشرة أعلاه، اذهب إلى صفحة Windows Hub releases وافتح أحدث إصدار مستقر. للتفاصيل راجع وثائق منصة Windows الرسمية.

بديل Windows: تطبيق سطح المكتب متعدد المنصات Tauri — تُنشر حزمة التثبيت OpenClaw-<version>-windows-x86_64.exe مع OpenClaw الإصدار الرسمي (GitHub Releases)، ويمكن استخدامه لتهيئة Gateway محلي على Windows عبر Bun المدمج، أو الاتصال بـ Gateway بعيد.

مستخدمو macOS: تطبيق شريط القوائم ​

نسخة سطح المكتب لـ macOS هي تطبيق رفيق في شريط القوائم: نزّل من OpenClaw GitHub Releases ملف OpenClaw-<version>.dmg (الخيار الأول) أو .zip، ثم ثبّت وشغّل OpenClaw.app.

متطلبات النظام: macOS 26.2 (Tahoe) أو أحدث.

المفترض أن ترى: عند أول تشغيل بعد تثبيت جديد تظهر نافذة تقدم — يجهّز App بيئة التشغيل المدمجة، ويشغّل Gateway على «This Mac»، ويفتح مربع حوار onboarding للوحة التحكم؛ وبعد الجاهزية تُغلق النافذة تلقائيًا. بعدها يبقى أيقونة OpenClaw دائمًا في شريط القوائم، وQuick Chat يُستدعى افتراضيًا بـ ⌥Space.

💡 أحدث Release لا يحتوي على حزمة macOS؟

بعض الإصدارات تحتوي فقط على CLI أو أصول Windows. التوجيه الرسمي: استخدم أحدث إصدار يحتوي على حزمة macOS — صفحة تطبيق macOS الرسمية تثبّت حاليًا ملفات DMG الثلاثة الخاصة بـ 2026.10.3 (Apple Silicon / Intel / Universal)، وللتفاصيل راجع وثائق تطبيق macOS الرسمية.

  • تم تشغيل تطبيق سطح المكتب: تحولت أيقونة الصينية في Windows إلى اللون الأخضر، أو ظهر أيقونة OpenClaw في شريط قوائم macOS

الخطوة 2: تشغيل Gateway داخل حاوية باستخدام Docker ​

لماذا: تصنّف الجهة الرسمية مسار OpenClaw Docker على أنه «اختياري» — يناسب من يريد بيئة Gateway معزولة وقابلة للتخلص منها، أو خادمًا لا يُجرى عليه تثبيت محلي. أما للاستخدام اليومي على جهاز التطوير الخاص بك، فتوصي الجهة الرسمية باتباع مسار التثبيت العادي (الدرس السابق).

جهّز المتطلبات المسبقة أولًا:

  • Docker Desktop (أو Docker Engine) + Docker Compose v2
  • للبناء المحلي للصورة من المصدر يلزم ذاكرة لا تقل عن 6 GB — يمكن تجاوز هذا الشرط باستخدام الصورة الرسمية المبنية مسبقًا
  • مساحة قرص كافية للصورة والسجلات

ثم أربعة أوامر (يجب تشغيل سكربت setup من جذر المستودع، فاستنسخه أولًا):

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

OPENCLAW_IMAGE يشير إلى الصور الرسمية المبنية مسبقًا (سجل GitHub Container Registry هو قناة النشر الرئيسية، صفحة الحزمة)؛ عند عدم تعيينه، يقوم السكربت ببناء openclaw:local محليًا. يُنشر نفس الإصدار (Release) أيضًا كصورة openclaw/openclaw على Docker Hub. تحذر الوثائق الرسمية صراحةً: استخدم هذين العنوانين الرسميين فقط وتجنب المرايا الخارجية—فإيقاع النشر وسياسات الاحتفاظ لديها غير متزامنين. لتثبيت إصدار محدد استخدم وسم إصدار صريحًا (مثل 2026.9.3)؛ تتوفر متغيرات مثل slim و-browser (مع Chromium مدمج)، والصورة الافتراضية تضم إضافات codex وdiagnostics-otel.

يجب أن ترى: يُكمل setup عملية onboarding تلقائيًا—يطلب إدخال provider API Key ← يُنشئ Gateway token ويكتبه في .env ← يشغّل Gateway عبر Docker Compose.

افتح Control UI: زُر http://127.0.0.1:18789/ في المتصفح، والصق الـ token من .env في Settings. إذا نسيت العنوان فاسترجعه مرة أخرى:

bash
docker compose run --rm openclaw-cli dashboard --no-open

فحص صحة الحاوية (بدون مصادقة، وهو ما يستهدفه HEALTHCHECK المدمج في الصورة):

bash
curl -fsS http://127.0.0.1:18789/healthz

يجب أن ترى: healthz يستجيب بشكل طبيعي؛ و/startupz (فحص الإقلاع) و/readyz (الجاهزية العميقة) على المنفذ نفسه أيضًا.

  • curl http://127.0.0.1:18789/healthz يستجيب بشكل طبيعي، ويمكن الدخول إلى Control UI بالـ token الموجود في .env

💡 تريد التشغيل على خادم 7×24؟

تأخذك هذه الخطوة فقط إلى تشغيل Gateway الحاوياتي. أما اختيار VPS وتشغيل compose وقواعد أمان التعرض للشبكة العامة (بما في ذلك سلسلة جدار حماية Docker DOCKER-USER)، فانظر نشر الخادم: تشغيل 7×24 على Docker/VPS والتقوية الأمنية (1).

الخطوة 3: تثبيت مباشر عبر npm / pnpm / Bun ​

لماذا: المطورون الذين يديرون Node بأنفسهم لا يحتاجون إلى مُثبِّت يتولى ذلك عنهم—تثبيت OpenClaw عبر npm (والأمر نفسه ينطبق على pnpm / Bun) يتم بأمر واحد، ثم شغّل onboarding لتثبيت Gateway كخدمة خلفية. هذا أيضًا هو المسار القياسي في CI وعلى الأجهزة المجمّعة.

المتطلبات: Node 24.16.0+ (‎24.x) أو 26.1.0+ (توصي الوثائق الرسمية بقوة بـ 24.22.1+ / 26.12.1+). تحقق أولًا بـ node --version.

الطريقة A: npm (‏npm 12 أو 11.16+) ​

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

npm 11.15 وما قبله: احذف --allow-scripts=openclaw (ذلك الإصدار لا يتضمن هذه السياسة ولا هذا الخيار أصلًا).

سبب إضافة --allow-scripts: npm 12 يحظر افتراضيًا سكربتات دورة حياة الحزم غير المعتمدة، وبدونها سيُبلَّغ عن preinstall / postinstall الخاصة بـ OpenClaw بالخطأ blocked because they are not covered by allowScripts. أما npm 11.16 فيقبل هذا الخيار لكنه يكتفي بالتحذير وينفّذ كالمعتاد.

الطريقة B: pnpm ​

bash
pnpm add -g --allow-build=openclaw openclaw@latest
openclaw onboard --install-daemon

يتطلب pnpm موافقة صريحة على الحزم ذات سكربتات البناء، كما أن approve-builds -g لا يدعم التثبيت العام—لذلك نكتب --allow-build=openclaw مباشرةً في أمر التثبيت.

الطريقة C: Bun ​

bash
bun add -g --trust openclaw@latest
bun run --bun openclaw onboard --install-daemon --daemon-runtime bun

--trust يسمح بمرور سكربتات دورة حياة حزمة OpenClaw؛ وbun run --bun يفرض استخدام وقت تشغيل Bun، بينما --daemon-runtime bun يثبّت Gateway المُدار تحت Bun. إصدارات Bun 1.4.4 وما فوق فقط تستطيع تشغيل CLI الخاص بـ OpenClaw والـ agent المحلي وGateway؛ ولا يزال Node هو وقت التشغيل الرئيسي—الملف التنفيذي openclaw المجرد يحتفظ بـ shebang الخاص بـ Node.

يجب أن ترى: نتيجة الطرق الثلاث بعد التثبيت واحدة—أمر openclaw متاح، وعملية onboarding تسير كالمعتاد، وGateway مثبّت كخدمة خلفية.

  • يطبع openclaw --version رقم الإصدار في الطرفية

💡 التثبيت اليدوي عبر npm وسياسة «الحداثة»

المُثبِّت الرسمي المُدار يزيل فلاتر حداثة npm مثل min-release-age لحزمة OpenClaw؛ أما عند تنفيذ npm install -g يدويًا، فتظل سياسات npm الخاصة بك سارية كالمعتاد. إذا علّقت السياسة عملية التثبيت، فافحص إعدادات npm أولًا.

الخطوة 4: تثبيت OpenClaw عبر الترجمة من المصدر ​

لماذا: هذا مسار المساهمين، أو من يريد تشغيل أحدث main، أو من يرغب في تعديل المصدر—استنسخ المصدر من GitHub، وابنِه بـ pnpm، واربط CLI بهذه النسخة (checkout).

bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
corepack enable
pnpm install && pnpm build && pnpm ui:build
pnpm add --global "openclaw@link:$PWD"
openclaw onboard --install-daemon

ثلاث تفاصيل:

  • pnpm add --global "openclaw@link:$PWD" يربط CLI بالنسخة (checkout) الحالية دون تعديل ملفات الحزمة؛ وإذا أبلغ pnpm أن مجلد الـ bin العام ليس في PATH، فشغّل pnpm setup وأعد فتح الطرفية ثم أعد المحاولة
  • يختار Corepack إصدار pnpm الدقيق وفق package.json (حاليًا pnpm 12)
  • للنسخ (checkout) على الخوادم التي تشغّل Gateway فقط، يمكن استخدام pnpm build:runtime (لا يُنتج تصريحات TypeScript)؛ وإذا لم ترغب في التثبيت العام فشغّل pnpm openclaw ... مباشرةً داخل المستودع

يجب أن ترى: تكتمل البنية دون أخطاء، وopenclaw يشير إلى هذه النسخة المحلية من المصدر.

  • ينتهي كل من pnpm build وpnpm ui:build دون أخطاء

الخطوة 5: التحقق من التثبيت—ثلاثة أوامر للتأكد من أن Gateway يعمل ​

لماذا: أيًّا كان المسار الذي اتخذته، بعد التثبيت تُستخدم المجموعة نفسها من الأوامر للتأكد—أن CLI موجود، وأن الإعدادات سليمة، وأن Gateway يعمل.

bash
openclaw --version      # CLI 可用
openclaw doctor         # 检查配置问题
openclaw gateway status # Gateway 正在运行

يجب أن ترى: --version يطبع رقم الإصدار (المرجع في هذا الدرس v2026.10.9)؛ وdoctor يقدّم نتيجة الفحص؛ وgateway status يُظهر أن Gateway يعمل ويستمع على 18789.

العملية المقابلة في مسار Docker (‏Gateway داخل الحاوية، وليس موجودًا على الجهاز المضيف):

bash
docker compose run --rm openclaw-cli dashboard --no-open   # 重新拿到 Control UI 地址
curl -fsS http://127.0.0.1:18789/healthz                   # 容器健康检查
  • تنجح أوامر التحقق الثلاثة جميعها (في مسار Docker تُستخدم healthz + dashboard)

نقطة تحقق ✅ ​

  • مسار النسخة المكتبية: أيقونة Windows Hub في شريط النظام تتحول إلى الأخضر، أو أن تطبيق شريط القوائم في macOS فتح onboarding الخاص بالـ dashboard
  • مسار Docker: http://127.0.0.1:18789/healthz يستجيب بشكل طبيعي، ودخلت إلى Control UI بالـ token الموجود في .env
  • مسار npm / pnpm / Bun: openclaw --version يُخرج نتيجة، واكتملت عملية onboarding
  • مسار المصدر: pnpm build && pnpm ui:build انتهى دون أخطاء، وopenclaw مرتبط بالنسخة (checkout) المحلية
  • أستطيع بالنظر إلى جدول «الفكرة الأساسية» تحديد المسار المناسب لسيناريوهي

تنبيهات للمزالق ​

❌ التثبيت المباشر عبر npm 12 يُبلِّغ عن blocked because they are not covered by allowScripts ​

السبب: npm 12 يحظر افتراضيًا سكربتات دورة حياة الحزم غير المعتمدة، فتم حظر preinstall / postinstall الخاصة بـ OpenClaw.

bash
# ❌ npm 12 不带参数
npm install -g openclaw@latest
# → blocked because they are not covered by allowScripts

# ✅ 带上允许脚本的参数
npm install -g openclaw@latest --allow-scripts=openclaw

احفظ فروق الإصدارات جيدًا: npm 11.16 يقبل هذا الخيار لكنه يكتفي بالتحذير وينفَّذ الأمر كالمعتاد؛ أما npm 11.15 والإصدارات الأقدم فلا تعرف هذه السياسة ولا هذا الخيار، لذا لا تُضمّنه في الأمر. بالإضافة إلى ذلك، الاقتراح npm approve-scripts openclaw الذي يوصي به npm 11.16 لا يعمل مع التثبيت العام — ستحصل على الخطأ ENOMATCH No installed packages match: openclaw.

❌ نظام macOS غير محدّث بما يكفي، لا يمكن تثبيت تطبيق شريط القوائم ​

السبب: يتطلب ‎OpenClaw.app‎ إصدار macOS 26.2 (Tahoe) أو أحدث، وهذا الحد الأدنى الصارم لا ينخفض لمجرد أن CLI يعمل — ثنائيات macOS الرسمية لـ Node 24 / 26 تدعم macOS 13.5+، لكن «عمل CLI» لا يعني «توافق التطبيق الأصلي».

الطريقة الصحيحة: على أجهزة Mac القديمة اتبع مسار تثبيت CLI من الدرس السابق (الثنائيات الرسمية لـ Node تدعم macOS 13.5+).

❌ بناء صورة Docker محليًا: الذاكرة غير كافية أو يفشل البناء ​

السبب: بناء صورة Gateway من المصدر محليًا يتطلب 6 GB من الذاكرة على الأقل.

الطريقة الصحيحة: استخدم الصورة الرسمية المبنية مسبقًا — نفّذ export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest" ثم شغّل setup؛ واستخدم فقط ghcr.io/openclaw/openclaw أو openclaw/openclaw من Docker Hub، وتجنّب الصور من أطراف ثالثة.

❌ بعد التثبيت العام عبر pnpm openclaw: command not found ​

السبب: دليل bin العام لـ pnpm غير موجود في PATH.

الطريقة الصحيحة: نفّذ pnpm setup، ثم أعد فتح الطرفية وحاول مجددًا (نص حرفي من قسم التثبيت من المصدر الرسمي). أما المشكلة المماثلة عند التثبيت العام عبر npm (وهي غالبًا متعلقة بـ PATH أيضًا) فانظر ماذا تفعل إذا فشل التثبيت.

نصائح متقدمة (اختيارية) ​

مثبّت البادئة المحلية: لا يلمس Node الخاص بالنظام. إذا أردت إبقاء OpenClaw وNode معًا تحت البادئة المحلية ~/.openclaw دون الاعتماد على Node على مستوى النظام:

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

يعتمد افتراضيًا على التثبيت عبر npm، ويدعم أيضًا التثبيت من git checkout تحت نفس البادئة؛ وبعد التثبيت استخدم openclaw update --channel dev / --channel stable للتبديل بين تثبيت الحزمة وتثبيت git.

التثبيت عبر Bun فقط (الـ fork الرسمي المثبّت بالإصدار). على macOS وLinux بـ glibc (arm64 / x64) يمكنك تنفيذ عملية التثبيت كاملة دون تثبيت Node:

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

يقوم بتنزيل الـ fork الخاص بـ Bun المثبّت في هذا الإصدار (Release) الخاص بـ OpenClaw والتحقق منه؛ وعند حذف --runtime يبقى Node هو الافتراضي. على macOS يقوم عند الحاجة بتثبيت SQLite عبر Homebrew (‏OpenClaw على Bun يرفض SQLite الخاص بنظام Apple). لمزيد من التفاصيل انظر وثائق Bun الرسمية.

تشغيل أحدث main (دون تجميع يدوي). إذا لم ترغب في التجميع الكامل من المصدر لكنك تريد متابعة فرع main:

bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

‏Podman / Nix / منصات سحابية. لا تريد استخدام Docker؟ يوفر المسؤولون مسارًا بديلًا عبر Podman rootless (‏./scripts/podman/setup.sh، مع CLI على الجهاز المضيف كواجهة تحكم)؛ وNix للتثبيت التصريحي عبر flake؛ وAnsible للنشر بالجملة. أما النشر على المنصات السحابية (Cloudflare وRender وFly وRailway وغيرها) وعلى VPS بـ 7×24 فانظر نشر على الخوادم.

خلاصة الدرس ​

✅ فُتحت جميع المسارات البديلة لتنزيل OpenClaw: نسخة سطح المكتب (Windows Hub / شريط قوائم macOS / بديل Tauri لـ Windows)، وDocker عبر الحاويات، والتثبيت المباشر عبر npm / pnpm / Bun، والتجميع من المصدر — المسارات الأربعة تثبّت نفس المكونات: Gateway + CLI + الإعدادات، فاختر واحدًا حسب السيناريو.

✅ أصبحت تعرف كيف تختار نسخة سطح المكتب: على Windows يوصي المسؤولون بـ Windows Hub (دون صلاحيات مسؤول، حزمة تثبيت موقّعة، Gateway مُدار ذاتيًا داخل WSL)؛ وتطبيق شريط قوائم macOS يتطلب macOS 26.2+.

✅ أصبحت تعرف تشغيل Docker: OPENCLAW_IMAGE + ./scripts/docker/setup.sh، مع إتمام onboarding تلقائيًا، وواجهة التحكم Control UI على 18789.

✅ حفظت فخاخ معاملات التثبيت المباشر: npm 12 / 11.16+ مع --allow-scripts=openclaw، وpnpm مع --allow-build=openclaw، وBun مع --trust.

مراجعة الأوامر الأساسية:

المسارالأوامر / الملفات الأساسيةالوصف
Windows HubOpenClawCompanion-Setup-x64.exe / -arm64.exeنسخة سطح المكتب الرسمية الموصى بها لـ Windows؛ تثبيت دون صلاحيات مسؤول
شريط قوائم macOSOpenClaw-<version>.dmgيتطلب macOS 26.2 (Tahoe) +
البديل لـ WindowsOpenClaw-<version>-windows-x86_64.exeتطبيق سطح مكتب مبني بـ Tauri، يمكن أن يتضمن Bun
DockerOPENCLAW_IMAGE + ./scripts/docker/setup.shGHCR هو القناة الرئيسية؛ ومرآة Docker Hub هي openclaw/openclaw
npmnpm install -g openclaw@latest --allow-scripts=openclawnpm 12 / 11.16+؛ وفي 11.15 والإصدارات الأقدم احذف المعامل
pnpmpnpm add -g --allow-build=openclaw openclaw@latestapprove-builds -g لا يدعم التثبيت العام
Bunbun add -g --trust openclaw@latestBun 1.4.4+؛ وNode لا يزال بيئة التشغيل الرئيسية
المصدرpnpm install && pnpm build && pnpm ui:buildيختار Corepack إصدار pnpm وفق package.json
التحقق العامopenclaw --version / openclaw doctor / openclaw gateway statusنفّذها مرة بعد التثبيت عبر أي مسار

القائمة الكاملة لمرجع الأوامر السريع في مرجع سريع لأوامر وإعدادات CLI.

استعراض الدرس القادم ​

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

ستتعلم:

  • خطوات تشخيص أخطاء فترة التثبيت مثل عدم مطابقة إصدار Node وopenclaw command not found
  • منهجية تشخيص تعذّر إقلاع Gateway
  • كيفية التعامل مع فشل التحديثات
gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.