التثبيت¶

هل تابعت بالفعل بدء؟ هل اتبعت بالفعل بدء الاستخدام؟ أنت جاهز — هذه الصفحة مخصّصة لطرق التثبيت البديلة، والتعليمات الخاصة بالمنصّات، وأعمال الصيانة.

متطلبات النظام¶

• Node 22+ (سيقوم برنامج التثبيت النصي بتثبيته إذا كان مفقودًا)
• macOS أو Linux أو Windows
• pnpm فقط إذا قمت بالبناء من المصدر

على Windows، نوصي بشدّة بتشغيل OpenClaw ضمن WSL2.

طرق التثبيت¶

يُعد برنامج التثبيت النصي الطريقة الموصى بها لتثبيت OpenClaw. فهو يتولّى اكتشاف Node وتثبيته والتهيئة الأولية في خطوة واحدة.

يقوم بتنزيل CLI وتثبيته بشكل عام عبر npm، ثم تشغيل معالج التهيئة الأولية.

```
<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```
  </Tab>
</Tabs>

هذا كل شيء — يتكفّل البرنامج باكتشاف Node وتثبيته والتهيئة الأولية.

لتجاوز التهيئة الأولية والاكتفاء بتثبيت الملف التنفيذي:

<Tabs>
  <Tab title="macOS / Linux / WSL2">
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```
  </Tab>
  <Tab title="Windows (PowerShell)">
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```
  </Tab>
</Tabs>

للاطلاع على جميع الأعلام ومتغيرات البيئة وخيارات CI/الأتمتة، راجع [Installer internals](/install/installer).
```

إذا كان لديك بالفعل Node 22+ وتفضّل إدارة التثبيت بنفسك:

```
<Tabs>
  <Tab title="npm">
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <Accordion title="أخطاء بناء sharp؟">
      إذا كان لديك libvips مثبتًا بشكل عام (شائع على macOS عبر Homebrew) وفشل `sharp`، فقم بفرض استخدام الثنائيات المُسبقة البناء:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      إذا رأيت `sharp: Please add node-gyp to your dependencies`، فإمّا أن تثبّت أدوات البناء (macOS: Xcode CLT + `npm install -g node-gyp`) أو استخدم متغير البيئة أعلاه.
    </Accordion>
  </Tab>
  <Tab title="pnpm">
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
    openclaw onboard --install-daemon
    ```

    <Note>
    يتطلّب pnpm موافقة صريحة للحِزم التي تحتوي على نصوص بناء. بعد أن يُظهر التثبيت الأول تحذير «Ignored build scripts»، شغّل `pnpm approve-builds -g` واختر الحِزم المدرجة.
    </Note>
  </Tab>
</Tabs>
```

للمساهمين أو لأي شخص يرغب في التشغيل من نسخة محلية.

```
<Steps>
  <Step title="الاستنساخ والبناء">
    استنسخ [مستودع OpenClaw](https://github.com/openclaw/openclaw) ثم ابنِ المشروع:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```
  </Step>
  <Step title="ربط CLI">
    اجعل الأمر `openclaw` متاحًا بشكل عام:

    ```bash
    pnpm link --global
    ```

    بديلًا عن ذلك، يمكنك تجاوز الربط وتشغيل الأوامر عبر `pnpm openclaw ...` من داخل المستودع.
  </Step>
  <Step title="تشغيل التهيئة الأولية">
    ```bash
    openclaw onboard --install-daemon
    ```
  </Step>
</Steps>

لمزيد من مسارات العمل التطويرية المتقدمة، راجع [الإعداد](/start/setup).
```

طرق تثبيت أخرى¶

عمليات نشر مُحاوَاة بالحاويات أو دون واجهة. تثبيت تصريحي عبر Nix. توفير الأسطول الآلي. استخدام CLI فقط عبر بيئة Bun.

بعد التثبيت¶

تحقّق من أن كل شيء يعمل كما ينبغي:

openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI

14. إذا كنت بحاجة إلى مسارات تشغيل مخصّصة، استخدم:

• 15. OPENCLAW_HOME لمسارات داخلية معتمدة على دليل المنزل
• 16. OPENCLAW_STATE_DIR لموقع الحالة القابلة للتغيير
• 17. OPENCLAW_CONFIG_PATH لموقع ملف الإعدادات

18. راجع Environment vars لمعرفة الأولوية وكامل التفاصيل.

استكشاف الأخطاء وإصلاحها: openclaw غير موجود¶

تشخيص سريع:

node -v
npm -v
npm prefix -g
echo "$PATH"

إذا لم يكن $(npm prefix -g)/bin (macOS/Linux) أو $(npm prefix -g) (Windows) موجودًا ضمن $PATH، فلن يتمكّن الصدَف لديك من العثور على ثنائيات npm العامة (بما في ذلك openclaw).

الإصلاح — أضِفه إلى ملف بدء تشغيل الصدَف لديك (~/.zshrc أو ~/.bashrc):

export PATH="$(npm prefix -g)/bin:$PATH"

على Windows، أضِف ناتج npm prefix -g إلى PATH.

ثم افتح طرفية جديدة (أو rehash في zsh / hash -r في bash).

التحديث / إلغاء التثبيت¶

حافظ على تحديث OpenClaw. الانتقال إلى جهاز جديد. إزالة OpenClaw بالكامل.