🧠 نظرة عامة

على عكس الإعدادات التقليدية، لا يتطلب MagicTradeBot تثبيتًا معقدًا أو تبعيات قاعدة بيانات. إنه محمول بالكامل ويعمل على Windows، macOS، وLinux — حتى على الخوادم الصغيرة أو الميكرو.

يعمل الروبوت بالكامل من خلال ملفات تهيئة بسيطة (YAML وJSON)، حيث تحدد استراتيجيات التداول، والبورصات، وفلاتر الإشارات الذكية، وقنوات الإشعارات.

📥 الخطوة 1: تحميل الروبوت

قم بزيارة الموقع الرسمي لـ MagicTradeBot وقم بتحميل أحدث إصدار لنظام التشغيل الخاص بك.

• سجل الدخول إلى حسابك وانتقل إلى قسم التحميل.
• اختر نظام التشغيل الخاص بك: Windows، macOS، أو Linux.
• يحتوي حسابك تلقائيًا على رخصة تجريبية (30 يومًا، ميزات كاملة). يمكنك الترقية إلى Basic أو Pro في أي وقت.

📦 ما يتم تضمينه

⚙️ الخطوة 2: تهيئة الروبوت

بعد تحميل وفك ضغط MagicTradeBot، ستجد ملفًا تنفيذيًا مع عدة ملفات تهيئة (YAML وJSON). تحدد هذه الملفات سلوك الروبوت، واتصاله بالبورصات، وبث إشارات التداول.

🔑 تهيئة الرخصة

افتح ملف appsettings.yaml وأضف مفتاح الرخصة الصالح الخاص بك. يمكنك إنشاء أو ترقية رخصتك في أي وقت من لوحة تحكم MagicTradeBot.

# -----------------------------------------------------------
# إعدادات الرخصة
# -----------------------------------------------------------
License:
  Key: "your_license_here"   # أدخل مفتاح الرخصة الصالح هنا
  # إنشاء، تمديد، أو ترقية على: https://magictradebot.com

📡 قنوات البث والإشعارات

يمكن لـ MagicTradeBot إرسال إشعارات التداول إلى المنصات المفضلة لديك مثل Discord، Telegram، أو WhatsApp. قم بتهيئة القنوات التي تخطط لاستخدامها فقط. اترك الخيارات غير المستخدمة كـ null.

# -----------------------------------------------------------
# قنوات البث / الإشعارات
# -----------------------------------------------------------
BroadCast:
  # قم بتهيئة المنصات التي تستخدمها فعليًا فقط.
  # اتركها كـ null إذا لم تكن هناك حاجة.

  # إشعارات WhatsApp
  whatsapp_token: null
  whatsapp_phone_id: null

  # إشعارات Discord
  discord_webhook_url: null

  # إشعارات Instagram
  instagram_token: null

  # إشعارات Telegram
  telegram_bot_token: null
  telegram_chat_id: null

بمجرد اكتمال إعدادات الرخصة والبث الأساسية، يكون الروبوت جاهزًا للبدء. للتهيئة المتقدمة — مثل بيانات اعتماد البورصة، استراتيجية التداول، وإعدادات الأتمتة الذكية — يرجى الرجوع إلى قسم التهيئة.

الروبوت يأتي مُهيأ مسبقًا لـ تداول السكالب. يمكنك تعديل كل معلمة بناءً على استراتيجيتك أو دمج مزودي الإشارات الخاصين بك.

🚀 الخطوة 3: تشغيل الروبوت

🪟 لنظام Windows

magictradebot.exe

🐧 لنظام Linux / macOS

chmod +x magictradebot-linux
./magictradebot-linux

هذا كل شيء! سيبدأ الروبوت تلقائيًا في مسح السوق، وتنفيذ التداولات بناءً على القواعد المُهيأة، وبث التحديثات إلى القنوات التي اخترتها.

📊 الخطوة 4: المراقبة والتعديل

يمكنك عرض السجلات في الطرفية أو تهيئة إخراج السجل الاختياري إلى log.yaml أو خدمات المراقبة الخارجية (Grafana Loki, Prometheus, Sentry).

قم بتعديل الإعدادات في أي وقت — فقط أوقف الروبوت، قم بتعديل ملفات YAML/JSON، وأعد التشغيل.

💡 لا يتطلب تثبيت

MagicTradeBot يعمل مباشرة — لا قاعدة بيانات، لا أطر عمل، لا إعداد معقد. فقط قم بالتحميل، التهيئة، وابدأ التداول. مثالي لـ VPS، أجهزة الكمبيوتر المصغرة، أو حاويات السحابة.

نصيحة احترافية: احتفظ بنسخ احتياطية من الإعدادات وقم بتحديث الروبوت بانتظام من الموقع الرسمي لضمان الأداء الأمثل والأمان.