First steps
بدء الاستخدام
ثبّت OpenClaw، وشغّل الإعداد الأولي، وابدأ الدردشة مع مساعد الذكاء الاصطناعي خلال نحو 5 دقائق. عند الانتهاء، سيكون لديك Gateway قيد التشغيل، ومصادقة مهيأة، وجلسة دردشة عاملة.
ما تحتاج إليه
- Node.js 22.19+ أو 23.11+ أو 24+ (الإصدار 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— تجاوز مسار ملف الإعدادات
المرجع الكامل: متغيرات البيئة.
