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

​
البدء

ثبّت OpenClaw، وشغّل الإعداد التمهيدي، وابدأ الدردشة مع مساعدك المدعوم بالذكاء الاصطناعي — كل ذلك خلال نحو 5 دقائق. في النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مُعدّة، وجلسة دردشة عاملة.

​
ما الذي تحتاج إليه

  • Node.js — يُوصى بـ Node 24 (كما أن Node 22.14+ مدعوم أيضًا)
  • مفتاح API من موفّر نماذج (Anthropic أو OpenAI أو Google أو غيرها) — سيطلبه منك الإعداد التمهيدي
تحقق من إصدار Node لديك باستخدام node --version. لمستخدمي Windows: كل من Windows الأصلي وWSL2 مدعومان. يُعد WSL2 أكثر استقرارًا ويُنصح به للحصول على التجربة الكاملة. راجع Windows. هل تحتاج إلى تثبيت Node؟ راجع إعداد Node.

​
إعداد سريع

1

ثبّت OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
عملية برنامج التثبيت النصي
طرق تثبيت أخرى (Docker وNix وnpm): التثبيت.
2

شغّل الإعداد التمهيدي

openclaw onboard --install-daemon
يرشدك المعالج خلال اختيار موفّر نموذج، وتعيين مفتاح API، وتهيئة Gateway. يستغرق ذلك نحو دقيقتين.راجع الإعداد التمهيدي (CLI) للحصول على المرجع الكامل.
3

تحقق من أن Gateway يعمل

openclaw gateway status
يجب أن ترى أن Gateway يستمع على المنفذ 18789.
4

افتح لوحة التحكم

openclaw dashboard
سيؤدي هذا إلى فتح واجهة التحكم في متصفحك. إذا تم تحميلها، فهذا يعني أن كل شيء يعمل.
5

أرسل أول رسالة لك

اكتب رسالة في دردشة واجهة التحكم، ويُفترض أن تحصل على رد من الذكاء الاصطناعي.هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة للإعداد هي Telegram (مجرد رمز bot مميز). راجع القنوات للاطلاع على جميع الخيارات.
إذا كنت تحتفظ بإصدار مترجم أو مخصص من لوحة التحكم، فوجّه gateway.controlUi.root إلى دليل يحتوي على الأصول الثابتة المضمّنة وindex.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# انسخ ملفاتك الثابتة المضمّنة إلى ذلك الدليل.
ثم عيّن:
{
  "gateway": {
    "controlUi": {
      "enabled": true,
      "root": "$HOME/.openclaw/control-ui-custom"
    }
  }
}
أعد تشغيل gateway ثم أعد فتح لوحة التحكم:
openclaw gateway restart
openclaw dashboard

​
ماذا تفعل بعد ذلك

صِل قناة

Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.

الاقتران والأمان

تحكم فيمن يمكنه مراسلة وكيلك.

هيّئ Gateway

النماذج والأدوات وsandbox والإعدادات المتقدمة.

تصفح الأدوات

المتصفح وexec والبحث على الويب وSkills والإضافات.
إذا كنت تشغّل OpenClaw كحساب خدمة أو تريد مسارات مخصصة:
  • OPENCLAW_HOME — الدليل الرئيسي لحل المسارات الداخلية
  • OPENCLAW_STATE_DIR — تجاوز دليل الحالة
  • OPENCLAW_CONFIG_PATH — تجاوز مسار ملف الإعدادات
المرجع الكامل: متغيرات البيئة.