#openclaw#installation#quick-start#setup

تثبيت OpenClaw في 5 دقائق: دليل التشغيل الأول السلس

3 min read

معظم الدروس تُضيّع الناس عند هذه الخطوة تحديداً. هدف هذه المقالة بسيط: مساعدتك على النجاح من المحاولة الأولى.

ما الذي ستتعلمه

  • التحقق من المتطلبات الأساسية قبل التثبيت
  • تثبيت OpenClaw
  • إتمام الإعداد وإنشاء أول مساعد
  • فتح لوحة التحكم بنجاح

شيئان للتحقق منهما قبل التثبيت

لا تحتاج الكثير، لكن هذين الأمرين لا خيار فيهما:

1. Node.js (الإصدار LTS)

node --version
# إذا رأيت رقم إصدار، فأنت جاهز

2. مفتاح API لنموذج الذكاء الاصطناعي

إذا أردت استخدام نماذج سحابية مثل Anthropic Claude أو OpenAI، تحتاج مفتاح API. إذا أردت البقاء بالكامل دون اتصال، يمكنك استخدام نموذج محلي. تفترض هذه السلسلة استخدام نموذج سحابي بشكل افتراضي.

💡 لست متأكداً من كيفية الحصول على مفتاح API؟ ابحث عن "Anthropic API key" وستتمكن من إنجازه في دقائق قليلة.

تثبيت OpenClaw

تنصح الوثائق الرسمية بـ طريقة التثبيت المبنية على git، لأنها أسهل في التحديث والتصحيح لاحقاً.

macOS / Linux

# اتبع أوامر Quick Start من docs.openclaw.ai
# في معظم الحالات هذا سكريبت curl بسطر واحد

Windows

# تأكد أولاً من تثبيت Git وإضافته إلى PATH
git --version
 
# ثم اتبع دليل تثبيت Windows على docs.openclaw.ai

⚠️ عالق في "git not found" أو "openclaw is not recognized"؟ أضف Git إلى PATH الخاص بالنظام، ثم أعد تشغيل المحطة الطرفية وحاول مجدداً.

التشغيل الأول: احتضان مساعدك

بعد التثبيت، شغّل:

openclaw gateway

التشغيل الأول يفتح معالج الإعداد، الذي يطرح أسئلة بسيطة:

  1. أي نموذج ذكاء اصطناعي تريد استخدامه؟
  2. ما هو مفتاح API الخاص بك؟
  3. أين يجب أن تعيش مساحة العمل؟

أجب عليها وسيقوم OpenClaw بإنشاء أول مساعد لك.

💡 عالق لفترة طويلة عند "wake up my friend"؟ تحقق من مفتاح API واتصالك بالإنترنت وأي رسائل خطأ تظهر في المحطة.

ماذا تحصل بعد الإعداد؟

  • رمز لتسجيل الدخول إلى لوحة التحكم
  • ملف إعداد أساسي في ~/.openclaw/openclaw.json
  • أول مساعد ذكي لك، يعمل بالفعل

فتح لوحة التحكم

مع استمرار تشغيل Gateway، افتح متصفحك:

http://127.0.0.1:18789/

المواقف الشائعة

ما تراه ما تفعله
pairing required شغّل openclaw devices list، ثم openclaw devices approve <id>
طلب رمز الصق الرمز من الإعداد
لا استجابة تأكد من أن openclaw gateway لا يزال يعمل

الخطوة التالية

مساعدك الآن في منزله. بعد ذلك، سنجعل تدفق تسجيل الدخول وواجهة لوحة التحكم أقل غموضاً بكثير.

← السابق: التعرف على OpenClaw | 👉 لا مزيد من ارتباك لوحة التحكم