English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Install overview

داخليات المُثبّت

يشحن OpenClaw ثلاثة نصوص تثبيت، تُقدَّم من openclaw.ai.

النص البرمجي المنصة ما يفعله
install.sh macOS / Linux / WSL يثبّت Node عند الحاجة، ويثبّت OpenClaw عبر npm (افتراضيًا) أو git، ويمكنه تشغيل التهيئة الأولية.
install-cli.sh macOS / Linux / WSL يثبّت Node + OpenClaw داخل بادئة محلية (~/.openclaw) باستخدام npm أو أوضاع checkout عبر git. لا يتطلب root.
install.ps1 Windows (PowerShell) يثبّت Node عند الحاجة، ويثبّت OpenClaw عبر npm (افتراضيًا) أو git، ويمكنه تشغيل التهيئة الأولية.

أوامر سريعة

install.sh

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

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

install-cli.sh

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

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

install.ps1

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

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

install.sh

التدفق (install.sh)

  • اكتشاف نظام التشغيل

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

  • ضمان Node.js 24 افتراضيًا

    يتحقق من إصدار Node ويثبّت Node 24 عند الحاجة (Homebrew على macOS، ونصوص إعداد NodeSource على Linux apt/dnf/yum). لا يزال OpenClaw يدعم Node 22 LTS، حاليًا 22.16+، للتوافق.

  • ضمان Git

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

  • تثبيت OpenClaw

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

  • مهام ما بعد التثبيت

    • يحدّث خدمة Gateway محمّلة بأفضل جهد (openclaw gateway install --force، ثم إعادة التشغيل)
    • يشغّل openclaw doctor --non-interactive عند الترقيات وتثبيتات git (بأفضل جهد)
    • يحاول التهيئة الأولية عند ملاءمة ذلك (توفر TTY، وعدم تعطيل التهيئة الأولية، واجتياز فحوصات bootstrap/config)
    • يضبط SHARP_IGNORE_GLOBAL_LIBVIPS=1 افتراضيًا

    • اكتشاف checkout المصدر

    إذا شُغّل داخل checkout لـ OpenClaw (package.json + pnpm-workspace.yaml)، يعرض النص البرمجي:

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

    إذا لم يكن TTY متاحًا ولم تُضبط طريقة تثبيت، فسيستخدم npm افتراضيًا ويصدر تحذيرًا.

    يخرج النص البرمجي بالرمز 2 عند اختيار طريقة غير صالحة أو قيم --install-method غير صالحة.

    أمثلة (install.sh)

    افتراضي

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

    تخطي التهيئة الأولية

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

    تثبيت Git

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

    GitHub main عبر npm

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

    تشغيل تجريبي

    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run
    مرجع العلامات
    العلامة الوصف
    --install-method npm|git اختر طريقة التثبيت (الافتراضي: npm). الاسم البديل: --method
    --npm اختصار لطريقة npm
    --git اختصار لطريقة git. الاسم البديل: --github
    --version <version|dist-tag|spec> إصدار npm أو dist-tag أو مواصفة حزمة (الافتراضي: latest)
    --beta استخدم dist-tag بيتا إذا كان متاحًا، وإلا فارجع إلى latest
    --git-dir <path> دليل checkout (الافتراضي: ~/openclaw). الاسم البديل: --dir
    --no-git-update تخطَّ git pull لـ checkout موجود
    --no-prompt عطّل المطالبات
    --no-onboard تخطَّ التهيئة الأولية
    --onboard فعّل التهيئة الأولية
    --dry-run اطبع الإجراءات دون تطبيق التغييرات
    --verbose فعّل إخراج التصحيح (set -x، وسجلات npm بمستوى notice)
    --help اعرض الاستخدام (-h)
    مرجع متغيرات البيئة
    المتغير الوصف
    OPENCLAW_INSTALL_METHOD=git|npm طريقة التثبيت
    OPENCLAW_VERSION=latest|next|main|<semver>|<spec> إصدار npm أو dist-tag أو مواصفة حزمة
    OPENCLAW_BETA=0|1 استخدم بيتا إذا كان متاحًا
    OPENCLAW_GIT_DIR=<path> دليل checkout
    OPENCLAW_GIT_UPDATE=0|1 تبديل تحديثات git
    OPENCLAW_NO_PROMPT=1 تعطيل المطالبات
    OPENCLAW_NO_ONBOARD=1 تخطي التهيئة الأولية
    OPENCLAW_DRY_RUN=1 وضع التشغيل التجريبي
    OPENCLAW_VERBOSE=1 وضع التصحيح
    OPENCLAW_NPM_LOGLEVEL=error|warn|notice مستوى سجل npm
    SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 التحكم في سلوك sharp/libvips (الافتراضي: 1)

    install-cli.sh

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

  • تثبيت وقت تشغيل Node المحلي

    ينزّل أرشيف tarball مدعومًا ومثبت الإصدار لـ Node LTS (الإصدار مضمّن في النص البرمجي ويُحدّث بشكل مستقل) إلى <prefix>/tools/node-v<version> ويتحقق من SHA-256.

  • ضمان Git

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

  • تثبيت OpenClaw تحت البادئة

    • طريقة npm (الافتراضية): تثبّت تحت البادئة باستخدام npm، ثم تكتب الملتف إلى <prefix>/bin/openclaw
    • طريقة git: تستنسخ/تحدّث checkout (الافتراضي ~/openclaw) وتظل تكتب الملتف إلى <prefix>/bin/openclaw

  • تحديث خدمة Gateway المحمّلة

    إذا كانت خدمة Gateway محمّلة بالفعل من تلك البادئة نفسها، فسيشغّل النص البرمجي openclaw gateway install --force، ثم openclaw gateway restart، ويفحص صحة Gateway بأفضل جهد.

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

    افتراضي

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

    بادئة مخصصة + إصدار

    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

    تثبيت Git

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

    إخراج JSON للأتمتة

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

    تشغيل التهيئة الأولية

    curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard
    مرجع العلامات
    العلامة الوصف
    --prefix <path> بادئة التثبيت (الافتراضي: ~/.openclaw)
    --install-method npm|git اختر طريقة التثبيت (الافتراضي: npm). الاسم البديل: --method
    --npm اختصار لطريقة npm
    --git, --github اختصار لطريقة git
    --git-dir <path> دليل Git checkout (الافتراضي: ~/openclaw). الاسم البديل: --dir
    --version <ver> إصدار OpenClaw أو dist-tag (الافتراضي: latest)
    --node-version <ver> إصدار Node (الافتراضي: 22.22.0)
    --json إصدار أحداث NDJSON
    --onboard تشغيل openclaw onboard بعد التثبيت
    --no-onboard تخطي التهيئة الأولية (الافتراضي)
    --set-npm-prefix على Linux، فرض بادئة npm إلى ~/.npm-global إذا كانت البادئة الحالية غير قابلة للكتابة
    --help اعرض الاستخدام (-h)
    مرجع متغيرات البيئة
    المتغير الوصف
    OPENCLAW_PREFIX=<path> بادئة التثبيت
    OPENCLAW_INSTALL_METHOD=git|npm طريقة التثبيت
    OPENCLAW_VERSION=<ver> إصدار OpenClaw أو dist-tag
    OPENCLAW_NODE_VERSION=<ver> إصدار Node
    OPENCLAW_GIT_DIR=<path> دليل سحب Git لتثبيتات git
    OPENCLAW_GIT_UPDATE=0|1 تبديل تحديثات git لعمليات السحب الموجودة
    OPENCLAW_NO_ONBOARD=1 تخطي الإعداد الأولي
    OPENCLAW_NPM_LOGLEVEL=error|warn|notice مستوى سجل npm
    SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 التحكم في سلوك sharp/libvips (الافتراضي: 1)

    install.ps1

    التدفق (install.ps1)

  • Ensure PowerShell + Windows environment

    يتطلب PowerShell 5+.

  • Ensure Node.js 24 by default

    إذا كان غير موجود، يحاول التثبيت عبر winget، ثم Chocolatey، ثم Scoop. يظل Node 22 LTS، حاليًا 22.16+، مدعومًا للتوافق.

  • Install OpenClaw

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

  • Post-install tasks

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

  • Handle failures

    تبلغ عمليات التثبيت عبر iwr ... | iex و scriptblock عن خطأ نهائي دون إغلاق جلسة PowerShell الحالية. لا تزال عمليات التثبيت المباشرة عبر powershell -File / pwsh -File تخرج برمز غير صفري للأتمتة.

    • أمثلة (install.ps1)

    Default

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

    Git install

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

    GitHub main via npm

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

    Custom git directory

    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

    Dry run

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

    Debug trace

    # install.ps1 has no dedicated -Verbose flag yet.
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
    Flags reference
    العلم الوصف
    -InstallMethod npm|git طريقة التثبيت (الافتراضي: npm)
    -Tag <tag|version|spec> dist-tag أو إصدار أو مواصفة حزمة npm (الافتراضي: latest)
    -GitDir <path> دليل السحب (الافتراضي: %USERPROFILE%\openclaw)
    -NoOnboard تخطي الإعداد الأولي
    -NoGitUpdate تخطي git pull
    -DryRun طباعة الإجراءات فقط
    Environment variables reference
    المتغير الوصف
    OPENCLAW_INSTALL_METHOD=git|npm طريقة التثبيت
    OPENCLAW_GIT_DIR=<path> دليل السحب
    OPENCLAW_NO_ONBOARD=1 تخطي الإعداد الأولي
    OPENCLAW_GIT_UPDATE=0 تعطيل git pull
    OPENCLAW_DRY_RUN=1 وضع التشغيل التجريبي

    CI والأتمتة

    استخدم الأعلام/متغيرات البيئة غير التفاعلية للحصول على عمليات تشغيل قابلة للتنبؤ.

    install.sh (non-interactive npm)

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

    install.sh (non-interactive git)

    OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

    install-cli.sh (JSON)

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

    install.ps1 (skip onboarding)

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

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

    Why is Git required?

    Git مطلوب لطريقة تثبيت git. بالنسبة لتثبيتات npm، لا يزال يتم فحص/تثبيت Git لتجنب حالات فشل spawn git ENOENT عندما تستخدم التبعيات عناوين URL من git.

    Why does npm hit EACCES on Linux?

    تشير بعض إعدادات Linux إلى بادئة npm العمومية في مسارات مملوكة للجذر. يمكن لـ install.sh تبديل البادئة إلى ~/.npm-global وإلحاق عمليات تصدير PATH بملفات rc الخاصة بالصدفة (عند وجود تلك الملفات).

    sharp/libvips issues

    تضبط السكربتات افتراضيًا SHARP_IGNORE_GLOBAL_LIBVIPS=1 لتجنب بناء sharp مقابل libvips الخاص بالنظام. للتجاوز:

    SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
    Windows: "npm error spawn git / ENOENT"

    ثبّت Git for Windows، وأعد فتح PowerShell، ثم أعد تشغيل المثبت.

    Windows: "openclaw is not recognized"

    شغّل npm config get prefix وأضف ذلك الدليل إلى PATH الخاص بالمستخدم لديك (لا حاجة إلى لاحقة \bin على Windows)، ثم أعد فتح PowerShell.

    Windows: how to get verbose installer output

    لا يعرض install.ps1 حاليًا مفتاح -Verbose. استخدم تتبع PowerShell لتشخيصات مستوى السكربت:

    Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
    openclaw not found after install

    عادة ما تكون المشكلة متعلقة بـ PATH. راجع استكشاف أخطاء Node.js وإصلاحها.

    ذات صلة