نظرة عامة على التثبيت

التفاصيل الداخلية للمثبت

يُرفق OpenClaw بثلاثة نصوص تثبيت، يتم تقديمها من openclaw.ai.

النصالمنصةالوظيفة
install.shmacOS / Linux / WSLيثبت Node إذا لزم الأمر، يثبت OpenClaw عبر npm (الافتراضي) أو git، ويمكنه تشغيل الإعداد الأولي.
install-cli.shmacOS / Linux / WSLيثبت Node + OpenClaw في بادئة محلية (~/.openclaw). لا يتطلب صلاحيات root.
install.ps1Windows (PowerShell)يثبت Node إذا لزم الأمر، يثبت OpenClaw عبر npm (الافتراضي) أو git، ويمكنه تشغيل الإعداد الأولي.

أوامر سريعة

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

ℹ️ إذا نجح التثبيت ولكن لم يتم العثور على openclaw في طرفية جديدة، راجع استكشاف أخطاء Node.js.

install.sh

💡 موصى به لمعظم عمليات التثبيت التفاعلية على macOS/Linux/WSL.

التدفق (install.sh)

الخطوة 1: اكتشاف نظام التشغيل

يدعم macOS و Linux (بما في ذلك WSL). إذا تم اكتشاف macOS، يقوم بتثبيت Homebrew إذا كان مفقودًا.

الخطوة 2: التأكد من Node.js 22+

يفحص إصدار Node ويقوم بتثبيت Node 22 إذا لزم الأمر (Homebrew على macOS، نصوص إعداد NodeSource على Linux apt/dnf/yum).

الخطوة 3: التأكد من Git

يقوم بتثبيت Git إذا كان مفقودًا.

الخطوة 4: تثبيت OpenClaw

  • طريقة npm (الافتراضية): تثبيت npm عام
  • طريقة git: استنساخ/تحديث المستودع، تثبيت التبعيات باستخدام pnpm، البناء، ثم تثبيت الغلاف في ~/.local/bin/openclaw

الخطوة 5: مهام ما بعد التثبيت

  • يشغل openclaw doctor --non-interactive عند الترقية وعند التثبيت عبر git (بأقصى جهد ممكن)
  • يحاول تشغيل الإعداد الأولي عند الاقتضاء (TTY متاح، الإعداد الأولي غير معطل، وتمر فحوصات التمهيد/الإعداد)
  • يضبط الافتراضي SHARP_IGNORE_GLOBAL_LIBVIPS=1

اكتشاف نسخة المصدر

إذا تم التشغيل داخل نسخة مستنسخة من OpenClaw (package.json + pnpm-workspace.yaml)، يعرض النص خيارين:

  • استخدام النسخة المستنسخة (git)، أو
  • استخدام التثبيت العام (npm)

إذا لم يكن TTY متاحًا ولم يتم تعيين طريقة تثبيت، فإنه يستخدم npm بشكل افتراضي ويصدر تحذيرًا. يخرج النص برمز 2 لاختيار طريقة غير صالحة أو قيم غير صالحة لـ --install-method.

أمثلة (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

install-cli.sh

ℹ️ مصمم للبيئات التي تريد فيها وضع كل شيء تحت بادئة محلية (الافتراضي ~/.openclaw) دون الاعتماد على Node النظام.

التدفق (install-cli.sh)

الخطوة 1: تثبيت وقت تشغيل Node محلي

يقوم بتنزيل أرشيف Node (الافتراضي 22.22.0) إلى <prefix>/tools/node-v<version> والتحقق من SHA-256.

الخطوة 2: التأكد من Git

إذا كان Git مفقودًا، يحاول التثبيت عبر apt/dnf/yum على Linux أو Homebrew على macOS.

الخطوة 3: تثبيت OpenClaw تحت البادئة

يقوم بالتثبيت باستخدام npm مع --prefix <prefix>، ثم يكتب الغلاف في <prefix>/bin/openclaw.

أمثلة (install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

install.ps1

التدفق (install.ps1)

الخطوة 1: التأكد من PowerShell + بيئة Windows

يتطلب PowerShell 5+.

الخطوة 2: التأكد من Node.js 22+

إذا كان مفقودًا، يحاول التثبيت عبر winget، ثم Chocolatey، ثم Scoop.

الخطوة 3: تثبيت OpenClaw

  • طريقة npm (الافتراضية): تثبيت npm عام باستخدام -Tag المحدد
  • طريقة git: استنساخ/تحديث المستودع، تثبيت/بناء باستخدام pnpm، وتثبيت الغلاف في %USERPROFILE%\.local\bin\openclaw.cmd

الخطوة 4: مهام ما بعد التثبيت

يضيف دليل bin المطلوب إلى مسار PATH للمستخدم عندما يكون ذلك ممكنًا، ثم يشغل openclaw doctor --non-interactive عند الترقية وعند التثبيت عبر git (بأقصى جهد ممكن).

أمثلة (install.ps1)

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

ℹ️ إذا تم استخدام -InstallMethod git وكان Git مفقودًا، يخرج النص ويطبع رابط Git for Windows.

CI والأتمتة

استخدم أعلام/متغيرات بيئة غير تفاعلية لتشغيلات يمكن التنبؤ بها.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

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

التثبيتDocker