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

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

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

​
الإعداد السريع

1

تثبيت OpenClaw

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

تشغيل الإعداد الأولي

openclaw onboard --install-daemon
يرشدك المعالج خلال اختيار موفّر نماذج، وتعيين مفتاح API، وتهيئة Gateway. لا يستغرق QuickStart عادةً سوى بضع دقائق، لكن تسجيل الدخول لدى الموفّر، أو إقران القنوات، أو تثبيت البرنامج الخفي، أو تنزيلات الشبكة، أو Skills، أو Plugins الاختيارية قد تجعل الإعداد الأولي الكامل يستغرق وقتًا أطول. يمكنك تخطي الخطوات الاختيارية والعودة لاحقًا باستخدام openclaw configure.راجع الإعداد الأولي (CLI) للاطلاع على المرجع الكامل.
3

التحقق من أن Gateway قيد التشغيل

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

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

openclaw dashboard
يفتح هذا Control UI في متصفحك. إذا تم تحميله، فكل شيء يعمل.
5

إرسال رسالتك الأولى

اكتب رسالة في دردشة Control UI، وينبغي أن تحصل على رد من الذكاء الاصطناعي.هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة يمكن إعدادها هي Telegram (مجرد رمز بوت). راجع القنوات للاطلاع على جميع الخيارات.
إذا كنت تدير بناء لوحة معلومات مترجمًا أو مخصصًا، فاجعل gateway.controlUi.root يشير إلى دليل يحتوي على الأصول الثابتة المبنية وindex.html.
mkdir -p "$HOME/.openclaw/control-ui-custom"
# Copy your built static files into that directory.
ثم عيّن:
{
  "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

النماذج، والأدوات، وبيئة الاختبار المعزولة، والإعدادات المتقدمة.

تصفح الأدوات

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

​
ذات صلة