> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بدء الاستخدام

# بدء الاستخدام

الهدف: الانتقال من الصفر إلى أول دردشة تعمل مع أقل قدر ممكن من الإعداد.

<Info>
  أسرع طريقة للدردشة: افتح واجهة التحكم (لا يلزم إعداد قناة). شغّل `openclaw dashboard`
  وتحدّث عبر المتصفح، أو افتح `http://127.0.0.1:18789/` على
  <Tooltip headline="Gateway host" tip="The machine running the OpenClaw gateway service.">مضيف Gateway</Tooltip>.
  الوثائق: [Dashboard](/web/dashboard) و[Control UI](/web/control-ui).
</Info>

## المسبق

* Node 22 أو أحدث

<Tip>
  تحقق من إصدار Node لديك باستخدام `node --version` إذا لم تكن متأكدًا.
</Tip>

## إعداد سريع (CLI)

<Steps>
  <Step title="Install OpenClaw (recommended)">
    <Tabs>
      <Tab title="macOS/Linux">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```

        <img src="https://mintcdn.com/veiseuleai/24AKr3LwoEceqr8Z/assets/install-script.svg?fit=max&auto=format&n=24AKr3LwoEceqr8Z&q=85&s=d1c8efb00167ca918bd206e558373c8e" alt="Install Script Process" className="rounded-lg" width="1370" height="581" data-path="assets/install-script.svg" />
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

    ````
    ```
    <Note>
    طرق التثبيت الأخرى والمتطلبات: [Install](/install).

    </Note>
    ```
    ````
  </Step>

  <Step title="Run the onboarding wizard">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw onboard --install-daemon
    ```

    ````
    ```
    يقوم المعالج بتهيئة المصادقة، وإعدادات Gateway، والقنوات الاختيارية.
    راجع [Onboarding Wizard](/start/wizard) للتفاصيل.
    ```
    ````
  </Step>

  <Step title="Check the Gateway">
    إذا قمت بتثبيت الخدمة، فيجب أن تكون قيد التشغيل بالفعل:

    `````
    ````
    ```bash
    openclaw gateway status
    ```
    ````
    `````
  </Step>

  <Step title="Open the Control UI">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw dashboard
    ```
  </Step>
</Steps>

<Check>
  إذا تم تحميل واجهة التحكم، فإن Gateway جاهز للاستخدام.
</Check>

## فحوصات إضافية وخيارات اختيارية

<AccordionGroup>
  <Accordion title="Run the Gateway in the foreground">
    مفيد للاختبارات السريعة أو استكشاف الأخطاء وإصلاحها.

    `````
    ````
    ```bash
    openclaw gateway --port 18789
    ```
    ````
    `````
  </Accordion>

  <Accordion title="Send a test message">
    يتطلب قناة مُهيّأة.

    `````
    ````
    ```bash
    openclaw message send --target +15555550123 --message "Hello from OpenClaw"
    ```
    ````
    `````
  </Accordion>
</AccordionGroup>

## متغيرات البيئة المفيدة

إذا قمت بتشغيل OpenClaw كحساب خدمة أو كنت تريد مواقع مخصصة للإعداد/الحالة:

* `OPENCLAW_HOME` يحدد الدليل الرئيسي المستخدم لحل المسارات الداخلية.
* `OPENCLAW_STATE_DIR` يتجاوز دليل الحالة.
* `OPENCLAW_CONFIG_PATH` يتجاوز مسار ملف الإعداد.

مرجع كامل لمتغيرات البيئة: [Environment vars](/help/environment).

## اذهب أعمق

<Columns>
  <Card title="Onboarding Wizard (details)" href="/start/wizard">
    مرجع كامل لمعالج CLI وخيارات متقدمة.
  </Card>

  <Card title="macOS app onboarding" href="/start/onboarding">
    مسار التشغيل الأول لتطبيق macOS.
  </Card>
</Columns>

## ما الذي ستحصل عليه

* Gateway يعمل
* تهيئة المصادقة
* وصول إلى واجهة التحكم أو قناة متصلة

## الخطوات التالية

* أمان الرسائل المباشرة والموافقات: [Pairing](/channels/pairing)
* توصيل المزيد من القنوات: [Channels](/channels)
* سير عمل متقدم والعمل من المصدر: [Setup](/start/setup)