تثبيت OpenClaw على macOS - دليل مصور

دليل شامل ومصور لتثبيت OpenClaw على جهاز Mac الخاص بك.

المتطلبات الأساسية

قبل البدء، تأكد من:

• ✅ macOS 12 (Monterey) أو أحدث
• ✅ اتصال إنترنت مستقر
• ✅ حساب مدير (Admin account)

لا تحتاج:

• ❌ خبرة سابقة في Terminal
• ❌ معرفة بالبرمجة
• ❌ برامج إضافية (سنثبت كل شيء معاً)

الطريقة 1: التثبيت التلقائي (الأسهل) ⚡

الخطوة 1: افتح Terminal

اضغط Cmd + Space، اكتب Terminal، ثم اضغط Enter.

🖥️ Terminal سيفتح نافذة سوداء (أو بيضاء حسب الإعدادات)

الخطوة 2: نفّذ أمر التثبيت

انسخ هذا الأمر بالكامل والصقه في Terminal:

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

ماذا يحدث؟

السكريبت سيقوم ب:

1. تحميل OpenClaw
2. تثبيت Node.js (إن لم يكن مثبتاً)
3. تكوين المسارات
4. التحقق من التثبيت

⏱️ الوقت المتوقع: 2-5 دقائق

الخطوة 3: أعد فتح Terminal

بعد انتهاء التثبيت:

1. أغلق نافذة Terminal الحالية
2. افتح نافذة جديدة
3. اكتب: openclaw --version

يجب أن ترى رقم الإصدار (مثلاً: 2026.2.2)

✅ تهانينا! التثبيت نجح.

الطريقة 2: عبر Homebrew 🍺

إذا كان لديك Homebrew مثبتاً:

الخطوة 1: افتح Terminal

# تحديث Homebrew
brew update

الخطوة 2: ثبّت OpenClaw

brew install openclaw

الخطوة 3: تحقق من التثبيت

openclaw --version

الطريقة 3: عبر npm (للمطورين) 👨‍💻

الخطوة 1: ثبّت Node.js

إذا لم يكن لديك Node.js:

# عبر Homebrew
brew install node

# أو حمّل من: https://nodejs.org

تحقق:

node --version  # يجب أن يكون >= 18

الخطوة 2: ثبّت OpenClaw

npm install -g openclaw

الخطوة 3: تحقق

openclaw --version

أول تشغيل - Wizard التكوين 🧙

عند أول تشغيل، سيفتح OpenClaw معالج التكوين:

openclaw

1. اختر القناة

? اختر قناة الدردشة الرئيسية:
  • Terminal (استخدام محلي فقط)
  • Telegram (موصى به)
  • Discord
  • WhatsApp

نصيحة: اختر Telegram للبدء - الأسهل!

2. أدخل API Key

? أدخل Anthropic API Key (للحصول عليه: https://console.anthropic.com)

كيف تحصل على API Key؟

1. اذهب لـ console.anthropic.com
2. سجّل دخول (أو أنشئ حساب)
3. اذهب لـ "API Keys"
4. اضغط "Create Key"
5. انسخ المفتاح (يبدأ بـ sk-ant-...)

3. ربط Telegram (إن اخترته)

? أدخل Telegram Bot Token (احصل عليه من @BotFather)

كيف تنشئ Bot؟

1. افتح Telegram
2. ابحث عن @BotFather
3. أرسل /newbot
4. اتبع التعليمات
5. انسخ Token (مثل: 123456:ABC-DEF...)

4. تم! 🎉

✅ التكوين اكتمل!
✅ OpenClaw جاهز للاستخدام

💬 ابدأ محادثة: openclaw
📚 التوثيق: https://docs.arabclaw.com

اختبار OpenClaw

من Terminal

openclaw chat "مرحباً، كيف حالك؟"

يجب أن يرد عليك Claude!

من Telegram

1. افتح Telegram
2. ابحث عن bot الخاص بك
3. أرسل رسالة: "مرحباً!"

حل المشاكل الشائعة

المشكلة 1: "command not found: openclaw"

الحل:

# أعد تحميل shell config
source ~/.zshrc   # إذا كنت تستخدم zsh (الافتراضي في macOS)
source ~/.bashrc  # إذا كنت تستخدم bash

# أو أعد فتح Terminal

المشكلة 2: "permission denied"

الحل:

# إصلاح الصلاحيات
sudo chown -R $(whoami) /usr/local

# ثم أعد التثبيت
curl -fsSL https://openclaw.com/install.sh | bash

المشكلة 3: "Node.js version too old"

الحل:

# حدّث Node.js عبر Homebrew
brew upgrade node

# أو حمّل أحدث إصدار من nodejs.org

المشكلة 4: "API key invalid"

الحل:

1. تحقق من API Key في console.anthropic.com
2. انسخه مرة أخرى (تأكد من نسخه كاملاً)
3. أعد التكوين:

openclaw config set anthropic.apiKey "sk-ant-YOUR-KEY-HERE"

المشكلة 5: بطء في التثبيت

الحل:

• تحقق من سرعة الإنترنت
• جرب وقت آخر
• استخدم طريقة بديلة (Homebrew أو npm)

تحديث OpenClaw

لتحديث لأحدث إصدار:

# إذا ثبّت عبر Script
curl -fsSL https://openclaw.com/install.sh | bash

# إذا ثبّت عبر Homebrew
brew upgrade openclaw

# إذا ثبّت عبر npm
npm update -g openclaw

إلغاء التثبيت (إن احتجت)

# عبر Homebrew
brew uninstall openclaw

# عبر npm
npm uninstall -g openclaw

# حذف الملفات المتبقية
rm -rf ~/.openclaw

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

الآن بعد التثبيت الناجح:

1. اقرأ دليل المبتدئين
2. ثبّت Skills مفيدة
3. استكشف التوثيق الكامل
4. انضم لمجتمع Discord

خلاصة

تثبيت OpenClaw على macOS سهل وسريع:

✅ 3 طرق مختلفة (تلقائي، Homebrew، npm)
✅ Wizard تكوين تفاعلي
✅ دعم Telegram/Discord/WhatsApp
✅ حل مشاكل شامل

مبروك! الآن لديك OpenClaw جاهز.

---

مشاكل؟ تواصل على Discord - نحن هنا للمساعدة! 💬