diff --git a/TELEGRAM_BOT_QUICKSTART.md b/TELEGRAM_BOT_QUICKSTART.md new file mode 100644 index 0000000..322e898 --- /dev/null +++ b/TELEGRAM_BOT_QUICKSTART.md @@ -0,0 +1,299 @@ +# 🚀 TELEGRAM BOT COMMANDS - QUICK START + +**5-Minuten Setup für sofortige Remote Control!** + +--- + +## ✅ SCHRITT 1: Dependencies installiert? + +Dependencies wurden bereits installiert beim Setup! ✅ + +**Check:** +```bash +python -m pip list | findstr telegram +``` + +**Sollte zeigen:** +``` +python-telegram-bot 13.15 +``` + +--- + +## ✅ SCHRITT 2: Telegram Config vorhanden? + +Config ist bereits vorhanden! ✅ + +**File:** `telegram_config.json` +- Bot Token: `7783303065:AAHVVvwWGqmhJ2BVq8LqkLRSsicKy1CUsD8` +- Chat ID: `8039713369` +- Bot Name: `@Xausd_digger_bot` + +--- + +## 🚀 SCHRITT 3: Bot im Notebook starten + +### 1. Öffne dein Jupyter Notebook: +``` +TradingBot_V1.6_Adaptive_Complete_CORRECTED.ipynb +``` + +### 2. Gehe zu **Cell 28** und führe sie aus: + +Die Cell sollte sein: +```python +# ========================================== +# TELEGRAM BOT COMMANDS - Background Service +# ========================================== + +from telegram_bot_commands import TelegramBotCommander, get_bot_controller +import threading + +# Start Telegram Bot in background +try: + print("🚀 Starting Telegram Bot Commander...") + + bot_commander = TelegramBotCommander() + bot_thread = bot_commander.start_background() + + # Get controller for integration with execute_trade + bot_controller = get_bot_controller() + + print("✅ Telegram Bot is running in background!") + print("📱 Available Commands:") + print(" /status - Bot status & positions") + print(" /pause - Pause trading") + print(" /resume - Resume trading") + print(" /close - Close all positions (requires confirm)") + print(" /balance - Account balance") + print(" /stats - Performance stats") + print(" /help - Show help") + +except Exception as e: + print(f"❌ Failed to start Telegram Bot: {e}") + bot_controller = None +``` + +**Erwartete Ausgabe:** +``` +✅ Telegram Bot Commander initialized +📱 Bot Token: 7783303065:AAHVVvwW... +👤 Chat ID: 8039713369 +✅ Command handlers registered +🚀 Starting Telegram Bot... +📱 Send /help to see available commands +✅ Bot is running. Press Ctrl+C to stop. +✅ Telegram Bot running in background +✅ Telegram Bot is running in background! +📱 Available Commands: + /status - Bot status & positions + ... +``` + +### 3. Führe **Cell 29** aus (Integration): + +Die Cell sollte sein: +```python +# ========================================== +# INTEGRATION: Bot Controller mit execute_trade +# ========================================== + +# Original execute_trade_v2_adaptive function wrappen +if 'bot_controller' in dir() and bot_controller is not None: + + # Original Funktion sichern + if '_original_execute_trade_before_telegram' not in dir(): + _original_execute_trade_before_telegram = execute_trade_v2_adaptive + + def execute_trade_with_telegram_control(*args, **kwargs): + """ + Wrapper der bot_controller.is_paused prüft + """ + # Check if trading is paused + if bot_controller.is_paused: + print("⏸️ Trading PAUSED via Telegram") + print(f" Reason: {bot_controller.pause_reason}") + return + + # Execute original function + return _original_execute_trade_before_telegram(*args, **kwargs) + + # Replace execute_trade + execute_trade_v2_adaptive = execute_trade_with_telegram_control + + print("✅ execute_trade_v2_adaptive wrapped with Telegram control") + print(" Trading can now be paused/resumed via /pause and /resume") +else: + print("⚠️ bot_controller not available, skipping integration") +``` + +**Erwartete Ausgabe:** +``` +✅ execute_trade_v2_adaptive wrapped with Telegram control + Trading can now be paused/resumed via /pause and /resume +``` + +--- + +## 📱 SCHRITT 4: Testen in Telegram + +### 1. Öffne Telegram App +- Auf deinem Handy oder Desktop + +### 2. Suche deinen Bot +- Gehe zu `@Xausd_digger_bot` +- Oder suche nach "Xausd digger bot" + +### 3. Sende `/start` +Du solltest bekommen: +``` +🤖 Trading Bot Commander + +Welcome! I can help you control your trading bot remotely. + +Send /help to see available commands. +``` + +### 4. Sende `/status` +Du solltest bekommen: +``` +📊 BOT STATUS + +✅ Status: ACTIVE + +💰 ACCOUNT +Balance: $7,166.00 +Equity: $7,234.00 +Margin: $145.00 +Free Margin: $7,089.00 + +📈 POSITIONS +Open: 2 +Floating P&L: $68.00 + +Open Trades: +1. 🟢 XAUUSD | 0.01 lots | $45.00 +2. 🟢 XAUUSD | 0.01 lots | $23.00 + +⏰ 2025-12-26 20:30:15 UTC +``` + +--- + +## ✅ FERTIG! + +Du hast jetzt **Remote Control** über deinen Trading Bot! 🎉 + +### Was du jetzt kannst: + +**📊 Status Check:** +``` +/status → Siehst Bot Status, Positionen, Balance +/balance → Siehst detaillierte Balance Info +/stats → Siehst Performance (heute, Woche, gesamt) +``` + +**⚙️ Bot Control:** +``` +/pause → Pausiert Trading (keine neuen Trades) +/resume → Aktiviert Trading wieder +/close confirm → Schließt ALLE Positionen (Emergency) +``` + +**❓ Hilfe:** +``` +/help → Zeigt alle Commands +``` + +--- + +## 🧪 SCHNELL-TEST + +### Test 1: Pause/Resume +1. Sende: `/pause` +2. Du bekommst: `✅ Trading PAUSED` +3. Sende: `/resume` +4. Du bekommst: `✅ Trading RESUMED` + +### Test 2: Balance Check +1. Sende: `/balance` +2. Du siehst: Balance, Equity, Margin, etc. + +### Test 3: Performance Stats +1. Sende: `/stats` +2. Du siehst: Trades heute, diese Woche, gesamt + +--- + +## 🐛 PROBLEMS? + +### Bot antwortet nicht? + +**Check 1:** Ist Cell 28 im Notebook ausgeführt? +- Gehe ins Notebook +- Check ob bei Cell 28 eine Zahl steht (z.B. `[28]`) +- Wenn nicht → Cell ausführen + +**Check 2:** Ist bot_controller aktiv? +- In Notebook neue Cell: + ```python + print(bot_controller) + print(bot_controller.is_paused) + ``` +- Sollte nicht `None` sein + +**Check 3:** Richtige Chat ID? +- In Notebook: + ```python + print(bot_commander.chat_id) + ``` +- Sollte sein: `8039713369` + +**Fix:** Cell 28 neu ausführen + +--- + +### Import Error? + +**Fehler:** +``` +ModuleNotFoundError: No module named 'telegram' +``` + +**Fix:** +```bash +python -m pip install python-telegram-bot==13.15 +``` + +Dann Cell 28 neu ausführen. + +--- + +## 💡 TIPPS + +### Tip 1: Schneller Zugriff +Speichere `/status` als Telegram Quick Reply. + +### Tip 2: Emergency Ready +Speichere `/close confirm` als Notfall-Command. + +### Tip 3: Regelmäßige Checks +Nutze `/stats` jeden Tag um Performance zu checken. + +--- + +## 📚 MEHR INFO? + +**Komplette Dokumentation:** +- `TELEGRAM_BOT_COMMANDS_GUIDE.md` + +**Use Cases & Troubleshooting:** +- Siehe TELEGRAM_BOT_COMMANDS_GUIDE.md + +--- + +**STATUS:** ✅ READY TO USE +**ZEIT:** 5 Minuten Setup +**IMPACT:** Vollständige Remote Control! 🚀 + +**Viel Erfolg!** 🎉