First steps
البدء
ثبّت OpenClaw، وشغّل الإعداد الأولي، وابدأ الدردشة مع مساعدك الذكي — كل ذلك في نحو 5 دقائق. وبحلول النهاية سيكون لديك Gateway قيد التشغيل، ومصادقة مهيأة، وجلسة دردشة تعمل.
ما الذي تحتاج إليه
- Node.js — يوصى باستخدام Node 24 (ويدعم أيضًا Node 22.14+)
- مفتاح 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
سيؤدي هذا إلى فتح Control UI في المتصفح لديك. وإذا تم تحميلها، فكل شيء يعمل.
أرسل رسالتك الأولى
اكتب رسالة في دردشة Control UI ويجب أن تتلقى ردًا من الذكاء الاصطناعي.
هل تريد الدردشة من هاتفك بدلًا من ذلك؟ أسرع قناة يمكن إعدادها هي Telegram (فقط رمز bot مميز). راجع القنوات للاطلاع على جميع الخيارات.
متقدم: ربط نسخة مخصصة من 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 restart
openclaw dashboard
ما الذي ينبغي فعله بعد ذلك
Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo وغير ذلك.
تحكم في من يمكنه مراسلة الوكيل الخاص بك.
النماذج، والأدوات، وsandbox، والإعدادات المتقدمة.
المتصفح، وexec، والبحث على الويب، وSkills، وPlugins.
متقدم: متغيرات البيئة
إذا كنت تشغّل OpenClaw كحساب خدمة أو تريد مسارات مخصصة:
OPENCLAW_HOME— الدليل الرئيسي لحل المسارات الداخليةOPENCLAW_STATE_DIR— تجاوز دليل الحالةOPENCLAW_CONFIG_PATH— تجاوز مسار ملف التهيئة
المرجع الكامل: متغيرات البيئة.