> ## Documentation index
> Fetch the complete documentation index at: https://tgcloud.docs7.io/llms.txt
> Ask it with GET https://tgcloud.docs7.io/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.

# حل المشكلات

> أخطاء شائعة وعلاجها

# حل المشكلات

## `"tgcloud login" requires an interactive terminal`

الواجهة تحتاج طرفية تفاعلية. استخدم `login_bot`: يمرر الرمز عبر stdin مع `TGCLOUD_ASSUME_TTY=1`. في CI: ‏`TGCLOUD_TOKEN='app...'`.

## `Token format looks wrong. Expected "app<id>:<secret>"`

أُرسل رمز Bot API. المطلوب هو **CLI access token**: ‏@BotFather ← البوت ← Serverless ← CLI Access.

## `Could not reach the tgcloud server`

`cloud.telegram.org` غير متاح. تحقق من الشبكة والبروكسي، ووجّه الواجهة عبر `TGCLOUD_CLI` إلى غلاف فيه `HTTPS_PROXY` و`NODE_USE_ENV_PROXY=1`.

## `This bot already has N deployed modules (revision R)`

السحابة والمشروع غير متزامنين: `fetch` ← `diff` ← `push` (أو عن علم `push { force: true, confirm: true }`).

## `non-interactive session — specify --safe, --yes, or --dry-run`

استخدم `migrate`. الافتراضي `--dry-run`. التطبيق يحتاج `dry_run: false` و`confirm: true`. يقابل `apply: "safe"` العلم `--safe` (يتجاوز حذف التحذير). ويقابل `apply: "yes"` العلم `--yes` (يطبّق حذف التحذير ويتجاوز تغيير النوع اليدوي).

## الأوامر ترفض مشروعًا فيه `schema.js` في الجذر

هذا تخطيط ما قبل CLI 0.2.0. نفّذ `upgrade` مع `dry_run: true` ثم `upgrade { dry_run: false, confirm: true }`.

## `chat not found` داخل `run_handler`

متوقع مع معرف دردشة وهمي: الكتابة في القاعدة تنجح، ويفشل فقط الإرسال الحقيقي إلى تيليغرام. منطق الـ handler يُنفَّذ رغم ذلك.

## لا سجلات من بوت منشور

لا يوجد أمر ينزّل سجلات بوت منشور. يلتقط `tgcloud run` (`run_handler`) مخرجات `console.*`، لكنه يشغّل ملفاتك المحلية على المنصة من غير نشر — وليس مخرجات البوت المنشور. لتشخيص فشل في النشر اقرأ `webhook_status` (`tgcloud webhook`): آخر خطأ تسليم وحالة التزامن هما أول دليل. ثم أعِد إنتاج المسار عبر `run_handler`.

## Mini App يعرض واجهة قديمة

`push` لا يشغّل المُجمّع. استدعِ `deploy`، أو ابنِ ثم انشر. `immutable` في `tgcloud.jsonc` يخزّن الملفات المطابقة لسنة؛ استعمله فقط للمسارات ذات التجزئة مثل `/assets/*`.