Add Telegram Bot Quick Start Guide
This commit is contained in:
@@ -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!** 🎉
|
||||
Reference in New Issue
Block a user