First steps
بدء الاستخدام
ثبّت OpenClaw، وشغّل الإعداد الأولي، ودردش مع مساعد الذكاء الاصطناعي لديك — كل ذلك في نحو 5 دقائق. في النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مهيأة، وجلسة دردشة عاملة.
ما تحتاج إليه
- Node.js — يُوصى باستخدام Node 24 (ويدعم أيضًا Node 22.19+)
- مفتاح API من موفّر نماذج (Anthropic، OpenAI، Google، إلخ.) — سيطلبه منك الإعداد الأولي
الإعداد السريع
تثبيت OpenClaw
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexتشغيل الإعداد الأولي
openclaw onboard --install-daemonيرشدك المعالج خلال اختيار موفّر نماذج، وتعيين مفتاح API،
وتهيئة Gateway. لا يستغرق QuickStart عادةً سوى بضع دقائق، لكن
تسجيل الدخول لدى الموفّر، أو إقران القنوات، أو تثبيت البرنامج الخفي، أو تنزيلات الشبكة، أو Skills،
أو Plugins الاختيارية قد تجعل الإعداد الأولي الكامل يستغرق وقتًا أطول. يمكنك تخطي الخطوات الاختيارية
والعودة لاحقًا باستخدام openclaw configure.
راجع الإعداد الأولي (CLI) للاطلاع على المرجع الكامل.
التحقق من أن Gateway قيد التشغيل
openclaw gateway statusيجب أن ترى أن Gateway يستمع على المنفذ 18789.
فتح لوحة المعلومات
openclaw dashboardيفتح هذا Control UI في متصفحك. إذا تم تحميله، فكل شيء يعمل.
إرسال رسالتك الأولى
اكتب رسالة في دردشة Control UI، وينبغي أن تحصل على رد من الذكاء الاصطناعي.
هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة يمكن إعدادها هي Telegram (مجرد رمز بوت). راجع القنوات للاطلاع على جميع الخيارات.
متقدم: تركيب بناء Control UI مخصص
إذا كنت تدير بناء لوحة معلومات مترجمًا أو مخصصًا، فاجعل
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 restartopenclaw dashboardما الخطوة التالية
Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo والمزيد.
تحكّم في من يستطيع مراسلة وكيلك.
النماذج، والأدوات، وبيئة الاختبار المعزولة، والإعدادات المتقدمة.
المتصفح، وexec، وبحث الويب، وSkills، وPlugins.
متقدم: متغيرات البيئة
إذا كنت تشغّل OpenClaw كحساب خدمة أو تريد مسارات مخصصة:
OPENCLAW_HOME— الدليل الرئيسي لحل المسارات الداخليةOPENCLAW_STATE_DIR— تجاوز دليل الحالةOPENCLAW_CONFIG_PATH— تجاوز مسار ملف التهيئة
المرجع الكامل: متغيرات البيئة.
