---
title: البداية السريعة
description: قم بتثبيت Klex وقم بتشغيل أول بوت Klex الخاص بك.
---

## التثبيت

بوتات Klex ذاتية الاستضافة. هذا يعني أنه يجب عليك تنزيل تطبيق Klex على جهاز يجب أن يعمل لاحقًا كمخزن للذاكرة وبيئة تنفيذ للبوت.

<Panel title="معلومات مفيدة">
لا يمكن للبوت الوصول تلقائيًا إلى أي ملفات على نظامك. بدلاً من ذلك، يعمل المضيف فقط كمكان يحدث فيه تفكير البوت وتخزين واسترجاع الذاكرة.

أي تفاعلات مع العالم الخارجي، بما في ذلك بيئات الاختبار أو الأجهزة الكاملة لـ **استخدام الكمبيوتر** أو التطوير، تتطلب صراحةً توصيل كمبيوتر عبر MCP。
</Panel>

لتثبيت Klex، قم بتشغيل البرنامج النصي التالي في غلاف النظام الخاص بك：

**macOS**

`curl -fsSL https://klex.bot/install.sh | sh`

**Linux**

`curl -fsSL https://klex.bot/install.sh | sh`

**Windows**

`irm https://klex.bot/install.ps1 | iex`

**WSL**

`curl -fsSL https://klex.bot/install.sh | sh`

## إنشاء البوت الخاص بك

**بدعم السحابة (موصى به)**

1. **سجل في Klex Cloud**

    انتقل إلى [Klex Cloud](https://cloud.klex.bot) وسجل. في الشريط الجانبي الأيسر، حدد لوحة Bots وانقر على `Set up a Klex Bot`.

2. **ابدأ Klex**

    اتبع الدليل في المعالج لتثبيت وبدء تطبيق Klex.

3. **أنشئ بوتًا جديدًا**

    في تطبيق Klex، حدد `Create a new Bot` في قائمة الخيارات واضغط على Enter.

4. **سمِّ بوتك**

    أدخل الاسم الذي يجب أن يستخدمه هذا البوت. سيعرف البوت أن هذا هو اسمه الخاص.

5. **سجل البوت في السحابة**

    اتبع التعليمات في معالج السحابة لتوصيل هذا البوت بمؤسسة Klex Cloud الخاصة بك.

6. **تكوين مزودي النماذج واختيار النماذج**

    سيطلب منك معالج السحابة الآن تكوين مزودي النماذج والنماذج التي تريد أن يستخدمها البوت.
    <Panel title="معلومات مفيدة">
      يتم إرسال بيانات اعتماد المزود بشكل آمن وتخزينها في تكوين البوت الخاص على الجهاز الذي يستضيف البوت، **وليس** في السحابة.
    </Panel>
    <Panel title="معلومات مفيدة">
    يدعم Klex مجموعة متنوعة من الاشتراكات، ومزودي الطرف الأول، ومزودي LLM المحليين، ومزودي API العامة.

    تعرف على المزيد حول [مزودي النماذج](/concepts/model-providers) و[اختيار النماذج](/concepts/model-selection)。
    </Panel>

7. **أعطِ البوت روحه**

    في الخطوة التالية، سيطلب منك المعالج تصميم روح البوت. لديك خياران：[وضع المنشئ](/concepts/soul#creator-mode)(*موصى به!*) و[وضع رسالة الله](/concepts/soul#god-message-mode)。

    [تعرف على المزيد حول الروح](/concepts/soul)。

8. **اتصل بـ MCP**

    امنح البوت الوصول إلى MCP. تساعدك **Klex Cloud** على إنشاء حسابات مخصصة للبوت بسهولة في كل تطبيق متكامل، ولكن يمكنك بالطبع أيضًا توصيل أي MCP آخر.

**مستقل**

<Panel title="مهم">
إذا كنت ترغب في استخدام بوتات Klex بدون Klex Cloud، فأنت بحاجة إلى التأكد من وجود MCP واحد على الأقل متصل يمكنه تشغيل البوت استباقيًا.
هذا يعني أن MCP **يجب** تنفيذ **أحد ما يلي**：

- المحادثات كمصادر MCP فردية مع إشعارات التغيير
- إشعارات الدفع وفقًا لـ [امتداد MCP](https://github.com/stagewise-io/klex/tree/main/packages/mcp-extension-push-notifications) الخاص بنا
</Panel>

1. **ابدأ Klex**

    ابدأ CLI بالأمر التالي：`klex --no-cloud`

2. **أنشئ بوتًا جديدًا**

    حدد `Create a new Bot` في قائمة الخيارات واضغط على Enter。

3. **سمِّ بوتك**

    أدخل الاسم الذي يجب أن يستخدمه هذا البوت. سيعرف البوت أن هذا هو اسمه الخاص.

4. **تكوين مزودي النماذج**

    انتقل إلى `Settings -> Model Providers` وأنشئ مثيل مزود لكل مزود نماذج تريد استخدامه.
    <Panel title="معلومات مفيدة">
    يدعم Klex مجموعة متنوعة من الاشتراكات، ومزودي الطرف الأول، ومزودي LLM المحليين، ومزودي API العامة。

    [تعرف على المزيد حول مزودي النماذج](/concepts/model-providers)。
    </Panel>

5. **تكوين اختيار النماذج**

    انتقل إلى `Settings -> Model Selection` وقم بتكوين النموذج لكل حالة استخدام للبوت.
    <Panel title="معلومات مفيدة">
    يجب عليك تكوين نموذج صالح لـ «Chat»، لكننا نوصي بشدة بتكوين جميع القدرات لضمان استخدام رخيص ووظائف كاملة.

    [تعرف على المزيد حول اختيار النماذج](/concepts/model-selection)。
    </Panel>

6. **أعطِ البوت روحه**

    انتقل إلى `Settings -> God messages` لإرسال `God message`. يجب أن يصف محتوى رسالة الله كيف يجب أن تبدو روح البوت (عمله، شخصيته، إلخ)。

    [تعرف على المزيد حول الروح](/concepts/soul)。

7. **اتصل بـ MCP**

    انتقل إلى `Settings -> MCPs` واتصل بـ MCP لمنح البوت الوصول إلى العالم الخارجي。