الخطوات الأولى
بدء الاستخدام
ثبّت OpenClaw، وشغّل الإعداد الأولي، وابدأ الدردشة مع مساعد الذكاء الاصطناعي في نحو 5 دقائق. عند الانتهاء، سيكون لديك Gateway قيد التشغيل، ومصادقة مهيّأة، وجلسة دردشة عاملة.
ما تحتاج إليه
- Node.js 22.22.3+ أو 24.15+ أو 25.9+ (الإصدار 24 هو الخيار الافتراضي الموصى به)
- مفتاح 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. لا تستغرق البداية السريعة عادةً سوى بضع دقائق، لكن
تسجيل الدخول إلى الموفّر، وإقران القناة، وتثبيت الخدمة الخفية، وتنزيلات الشبكة، وSkills،
أو Plugins الاختيارية قد تجعل الإعداد الأولي الكامل يستغرق وقتًا أطول. تخطَّ الخطوات
الاختيارية وعُد إليها لاحقًا باستخدام openclaw configure.
راجع الإعداد الأولي (CLI) للاطلاع على المرجع الكامل.
التحقّق من تشغيل Gateway
openclaw gateway statusيُفترض أن ترى Gateway يستمع على المنفذ 18789.
فتح لوحة المعلومات
openclaw dashboardيفتح هذا واجهة التحكم في متصفحك. إذا تم تحميلها، فكل شيء يعمل.
إرسال رسالتك الأولى
اكتب رسالة في دردشة واجهة التحكم، ويُفترض أن تتلقى ردًا من الذكاء الاصطناعي.
هل تفضّل الدردشة من هاتفك؟ أسرع قناة يمكن إعدادها هي Telegram (لا تتطلب سوى رمز بوت). راجع القنوات للاطلاع على جميع الخيارات.
متقدم: تحميل إصدار مخصص من واجهة التحكم
إذا كنت تدير إصدارًا مترجمًا أو مخصصًا من لوحة المعلومات، فاضبط
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 restartopenclaw dashboardما يجب فعله بعد ذلك
Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo وغيرها.
تحكّم فيمن يمكنه مراسلة وكيلك.
النماذج والأدوات وبيئة العزل والإعدادات المتقدمة.
المتصفح والتنفيذ والبحث على الويب وSkills وPlugins.
متقدم: متغيرات البيئة
إذا كنت تشغّل OpenClaw بحساب خدمة أو تريد مسارات مخصصة:
OPENCLAW_HOME— الدليل الرئيسي لحل المسارات الداخليةOPENCLAW_STATE_DIR— تجاوز دليل الحالةOPENCLAW_CONFIG_PATH— تجاوز مسار ملف التهيئة
المرجع الكامل: متغيرات البيئة.
