الانتقال إلى المحتوى الرئيسي

التثبيت

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

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

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

طرق التثبيت

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

Installer script

يقوم بتنزيل 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).
```

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

Docker

عمليات نشر مُحاوَاة بالحاويات أو دون واجهة.

Podman

حاوية Rootless: شغّل setup-podman.sh مرة واحدة، ثم نصّ الإطلاق.

Nix

تثبيت تصريحي عبر Nix.

Ansible

توفير الأسطول الآلي.

Bun

استخدام CLI فقط عبر بيئة Bun.

بعد التثبيت

تحقّق من أن كل شيء يعمل كما ينبغي:
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
إذا كنت بحاجة إلى مسارات تشغيل مخصّصة، استخدم:
  • OPENCLAW_HOME لمسارات داخلية معتمدة على دليل المنزل
  • OPENCLAW_STATE_DIR لموقع الحالة القابلة للتغيير
  • OPENCLAW_CONFIG_PATH لموقع ملف الإعدادات
راجع 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).

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

Updating

حافظ على تحديث OpenClaw.

Migrating

الانتقال إلى جهاز جديد.

Uninstall

إزالة OpenClaw بالكامل.