Files
Place-Order-Trading-Bot/TELEGRAM_BOT_QUICKSTART.md
T

300 lines
6.4 KiB
Markdown

# 🚀 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!** 🎉