بدء الاستخدام

ثبّت OpenClaw، وشغّل الإعداد الأولي، وابدأ الدردشة مع مساعد الذكاء الاصطناعي في نحو 5 دقائق. عند الانتهاء، سيكون لديك Gateway قيد التشغيل، ومصادقة مهيّأة، وجلسة دردشة عاملة.

ما تحتاج إليه

Node.js 22.22.3+ أو 24.15+ أو 25.9+ (الإصدار 24 هو الخيار الافتراضي الموصى به)
مفتاح API من موفّر نماذج (Anthropic أو OpenAI أو Google، إلخ) — سيطلبه منك الإعداد الأولي

تحقّق من إصدار Node باستخدام node --version. مستخدمو Windows: تطبيق Windows Hub الأصلي هو أسهل خيار لسطح المكتب. كما أن مسارات مُثبّت PowerShell وGateway عبر WSL2 مدعومة أيضًا. راجع Windows. هل تحتاج إلى تثبيت Node؟ راجع إعداد Node.

الإعداد السريع

تثبيت OpenClaw

macOS / Linux
Windows (PowerShell)

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

طرق تثبيت أخرى (Docker وNix وnpm): التثبيت.

تشغيل الإعداد الأولي

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 restart
openclaw dashboard

ما يجب فعله بعد ذلك

ربط قناة

Discord وFeishu وiMessage وMatrix وMicrosoft Teams وSignal وSlack وTelegram وWhatsApp وZalo وغيرها.

الإقران والأمان

تحكّم فيمن يمكنه مراسلة وكيلك.

تهيئة Gateway

النماذج والأدوات وبيئة العزل والإعدادات المتقدمة.

استعراض الأدوات

المتصفح والتنفيذ والبحث على الويب وSkills وPlugins.

متقدم: متغيرات البيئة

إذا كنت تشغّل OpenClaw بحساب خدمة أو تريد مسارات مخصصة:

OPENCLAW_HOME — الدليل الرئيسي لحل المسارات الداخلية
OPENCLAW_STATE_DIR — تجاوز دليل الحالة
OPENCLAW_CONFIG_PATH — تجاوز مسار ملف التهيئة

المرجع الكامل: متغيرات البيئة.

نظرة عامة

الخطوات الأولى

Guides

بدء الاستخدام

ما تحتاج إليه

الإعداد السريع

ما يجب فعله بعد ذلك

ربط قناة

الإقران والأمان

تهيئة Gateway

استعراض الأدوات

ذو صلة

​ما تحتاج إليه

​الإعداد السريع

​ما يجب فعله بعد ذلك

ربط قناة

الإقران والأمان

تهيئة Gateway

استعراض الأدوات

​ذو صلة

ما تحتاج إليه

الإعداد السريع

ما يجب فعله بعد ذلك

ذو صلة