First steps
بدء الاستخدام
ثبّت OpenClaw، وشغّل الإعداد الأولي، وتحدث مع مساعد الذكاء الاصطناعي الخاص بك — كل ذلك في نحو 5 دقائق. في النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مهيّأة، وجلسة دردشة عاملة.
ما تحتاجه
- Node.js — يُوصى باستخدام Node 24 (Node 22.16+ مدعوم أيضًا)
- مفتاح 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. يستغرق ذلك نحو دقيقتين.
راجع الإعداد الأولي (CLI) للاطلاع على المرجع الكامل.
تحقق من أن Gateway قيد التشغيل
openclaw gateway statusينبغي أن ترى Gateway يستمع على المنفذ 18789.
افتح لوحة التحكم
openclaw dashboardيفتح هذا واجهة التحكم في متصفحك. إذا تم تحميلها، فكل شيء يعمل.
أرسل رسالتك الأولى
اكتب رسالة في دردشة واجهة التحكم، وينبغي أن تتلقى ردًا من الذكاء الاصطناعي.
هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة يمكن إعدادها هي 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 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— تجاوز مسار ملف الإعدادات
المرجع الكامل: متغيرات البيئة.