رجوع
مركز المعرفة

شغّل بوتك أول مرة

من صفحة واحدة إلى أول سطر يطبعه بوتك، خطوة بخطوة.

آخر تحديث 2026-10-13
ابدأ من هنا

صفحة واحدة وبوتك شغّال

من «شغّل بوتك» تنجز كل شيء في صفحة واحدة:

  1. أين الكود؟: اختر ريبو من GitHub، أو ارفع مجلد بوتك أو ملف zip، أو ابدأ من قالب جاهز.
  2. ما وجدناه في الكود: نقرأ الكود ونتعرف على أنه بايثون، وعلى المكتبة (discord.py أو python-telegram-bot وغيرها)، والمنصة، وأمر التثبيت وأمر التشغيل. عدّل ما تريد قبل المتابعة.
  3. المتغيرات: أضف التوكن وكل متغير يقرأه كودك. نقترح عليك الأسماء التي وجدناها في الكود وفي .env.example.
  4. اختر الباقة: اختر باقتك واضغط ادفع وانشر.

أول نشر

بعد الدفع تُفتح صفحة بوتك، وتتابع النشر سطرًا بسطر:

  • نسحب الكود من الريبو، أو نفك الملف الذي رفعته.
  • ننشئ لبوتك بيئة بايثون خاصة به (.venv)، ونثبّت فيها المكتبات من أول ملف نجده من هذه الملفات بالترتيب: requirements.txt ثم uv.lock ثم poetry.lock ثم pdm.lock ثم Pipfile ثم pyproject.toml. ولا نعيد التثبيت إلا عند تغيّر المكتبات.
  • نشغّل أمر التشغيل في إعدادات بوتك إن وُجد، وإلا start في serverk.json، وإلا سطر worker أو bot من ملف Procfile، وإلا فأول ملف نجده من هذه الملفات بالترتيب: main.py ثم bot.py ثم app.py ثم src/main.py ثم src/bot.py، وإلا فـ python -m مع المجلد الوحيد الذي يحتوي __main__.py.

عند ظهور هذين السطرين في الكونسول، يكون بوتك قد بدأ:

serverk: deployment dep_a1b2c3d4 ready at 3f2a9c1b7d10
serverk: bot process starting

التوكن لا يوقف التشغيل

نشغّل بوتك حتى إذا كان في التوكن خلل، ويظهر الخطأ في الكونسول كما يطبعه بوتك. وبعد أن يسجّل بوتك الدخول ويطبع سطرًا مثل Logged in as MyBot، يظهر اسمه في بطاقة البوت مع رابط لإضافته إلى سيرفرك.

لا يوجد لديك بوت بعد؟

لدينا قوالب جاهزة فيها أمر /ping أو /start يشتغل فورًا: قالب ديسكورد و قالب تيليقرام. اختر القالب من «شغّل بوتك»، وننشئه لك ريبو في حسابك على GitHub، أو ننسخه داخل بوتك مباشرة.

هل ساعدك هذا الشرح؟

ساهم في تحسين هذا الشرح

الشروحات مفتوحة المصدر، فإذا كان لديك تصحيح أو إضافة، افتح Pull Request على github.com/serverkgg/bot-python