FAQ - Часто задаваемые вопросы
Быстрый старт
1. Получение Bot Token
- Откройте Telegram и найдите @BotFather
- Отправьте команду
/newbot - Следуйте инструкциям и сохраните полученный Bot Token
2. Получение вашего User ID
- Откройте @userinfobot
- Отправьте
/start - Сохраните ваш User ID
3. Получение OpenAI API Key
- Зарегистрируйтесь на OpenAI
- Создайте API ключ в разделе API Keys
- Сохраните API Key
4. Настройка через веб-админку
Все настройки теперь через веб-интерфейс!
Перейдите в раздел Settings и заполните:
Перейдите в раздел Settings и заполните:
- TELEGRAM_BOT_TOKEN - токен от @BotFather
- OWNER_USER_ID - ваш Telegram ID
- OPENAI_API_KEY - ключ OpenAI (опционально)
Пароль по умолчанию: admin123 (измените в production!)
5. Перезапуск после настройки
cd /root/telegram-ai-moderation
docker-compose restart
Подключение канала/группы
Шаги подключения:
- Откройте вашу Telegram группу/канал
- Добавьте бота как администратора
- Выдайте права:
- ✅ Delete messages (удаление сообщений)
- ✅ Ban users (бан пользователей)
- ✅ Restrict members (ограничение участников)
- Бот автоматически определит подключение
- Канал появится в разделе Chats
Важно: Без прав администратора модерация работать не будет!
Политика модерации
Zero Tolerance - Наркотики
⚠️ КРИТИЧНО: Любое упоминание наркотиков приводит к:
- Немедленному удалению сообщения
- Перманентному бану пользователя
- Уведомлению владельца
Система 1-2-3 для спама/дубликатов
- 1-е нарушение: Удаление + предупреждение
- 2-е нарушение: Удаление + предупреждение
- 3-е нарушение: Удаление + перманентный бан
Что детектируется:
- Наркотики (прямые названия, сленг, эмодзи-коды, обфускация)
- Точные дубликаты сообщений
- Похожие сообщения (fuzzy matching ≥85%)
- Шаблонный спам от одного пользователя
- Кастомные правила (настраиваются в Rules)
Платные криптовалютные объявления
Статус: Система реализована и готова к тестированию. Требуется настройка перед использованием.
💰 Как это работает
Система автоматически определяет криптовалютные объявления через AI и требует оплату $1 за каждое объявление.
$1
За объявление$50
Минимальный депозитTRC20
USDT Tron🎯 Сценарий использования
- Пользователь БЕЗ баланса отправляет крипто-рекламу:
- ❌ Сообщение удаляется
- 📨 Получает PM с уникальным TRC20 адресом
- 💰 Инструкции: минимум $50 USDT
- Пользователь делает депозит:
- ⏳ Система мониторит blockchain (каждые 60 сек)
- ✅ После 19 подтверждений (~1 мин) кредиты зачисляются
- 📨 Отправляется уведомление о депозите
- Пользователь С балансом отправляет крипто-рекламу:
- ✅ Списывается 1 кредит ($1)
- ✅ Сообщение РАЗРЕШАЕТСЯ
- 📊 Обновляется баланс
⚙️ Настройка (для администратора)
pip3 install tronpy==0.4.0
docker-compose restart app
КРИТИЧНО: Master seed используется для генерации ВСЕХ пользовательских кошельков. Храните в безопасности!
python3 << 'EOF'
import sqlite3, secrets
# Generate seed
master_seed = secrets.token_hex(32)
# Add to database
conn = sqlite3.connect('data/moderation.db')
cursor = conn.cursor()
cursor.execute("""
INSERT OR REPLACE INTO settings (key, value, value_type, description, is_sensitive)
VALUES (?, ?, ?, ?, ?)
""", ('TRON_MASTER_SEED', master_seed, 'string', 'Master seed for HD wallet derivation', 1))
conn.commit()
conn.close()
print(f"✅ TRON_MASTER_SEED: {master_seed}")
print("\n⚠️ BACKUP THIS SEED SECURELY!")
EOF
- Перейдите в раздел Chats
- Нажмите "Edit" на нужном канале
- Включите опцию "Enable Crypto Payments"
- Сохраните изменения
Важно: Crypto payments работают только для каналов, где эта опция включена. По умолчанию - выключено для всех каналов.
Внимание: НЕ запускайте мониторинг без предварительного тестирования!
Тестирование:
python3 << 'EOF'
import asyncio
from app.services.crypto_monitor_service import get_crypto_monitor_service
async def test():
monitor = get_crypto_monitor_service()
await monitor.initialize()
current_block = await monitor.get_current_block()
print(f"✅ Current Tron block: {current_block}")
asyncio.run(test())
EOF
Запуск мониторинга: Добавьте в startup код приложения после успешного тестирования.
📱 Команды для пользователей
/balance- Проверить баланс, адрес кошелька, статистику/cryptotx- История депозитов и объявлений
🔧 Troubleshooting
| Проблема | Решение |
|---|---|
| "tronpy not installed" | pip3 install tronpy==0.4.0 |
| "TRON_MASTER_SEED not configured" | Выполните Шаг 2 выше |
| Депозиты не обнаруживаются |
1. Проверьте что monitoring запущен 2. Транзакция = USDT TRC20 (не TRX!) 3. Минимум $50 USDT 4. Правильный адрес |
| Объявления удаляются с балансом |
1. Проверьте что crypto_payment_enabled=true для канала 2. Проверьте баланс в базе 3. Смотрите логи pipeline |
🔐 Безопасность
TRON_MASTER_SEED - КРИТИЧЕСКИЙ СЕКРЕТ!
НЕОБХОДИМО:
- ✅ Хранить в password manager (зашифровано)
- ✅ Создать backup (зашифрованный, offline)
- ✅ Ограничить доступ (только owner)
- ❌ НИКОГДА не коммитить в git
- ❌ НИКОГДА не логировать в plaintext
📊 Как проверить статус
# Проверить TRON_MASTER_SEED настроен
python3 -c "from app.config import settings; print(f'Configured: {settings.tron_master_seed is not None}')"
# Проверить crypto tables
python3 -c "import sqlite3; conn = sqlite3.connect('data/moderation.db'); cursor = conn.cursor(); cursor.execute(\"SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'crypto%'\"); print([r[0] for r in cursor.fetchall()])"
# Проверить каналы с включенным crypto payment
python3 -c "import sqlite3; conn = sqlite3.connect('data/moderation.db'); cursor = conn.cursor(); cursor.execute(\"SELECT title, crypto_payment_enabled FROM moderated_chats\"); print([r for r in cursor.fetchall()])"
Использование веб-админки
Разделы:
- Dashboard - метрики и статистика
- Messages - все обработанные сообщения
- Users - управление пользователями, баны
- Rules - настройка правил модерации
- Reports - суточные отчёты
- Chats - управление подключёнными каналами
- System - статус системы, настройки
Логин по умолчанию:
Username: admin
Password: admin123
⚠️ Измените пароль в production!
Password: admin123
⚠️ Измените пароль в production!
Решение проблем
Бот не отвечает
# Проверьте логи
docker-compose logs -f app
# Проверьте .env файл
nano /root/telegram-ai-moderation/.env
# Перезапустите
docker-compose restart
Веб-админка не открывается
# Проверьте статус контейнеров
docker-compose ps
# Проверьте порт 8000
netstat -tlnp | grep 8000
# Проверьте firewall
ufw status
ufw allow 8000/tcp
Redis connection error
# Перезапустите Redis
docker-compose restart redis
# Проверьте логи
docker-compose logs redis
OpenAI ошибки
- Проверьте OPENAI_API_KEY в .env
- Проверьте баланс на OpenAI
- Временно отключите AI:
ENABLE_AI_CLASSIFICATION=false
Полезные команды
Docker управление
# Просмотр логов
docker-compose logs -f
# Статус контейнеров
docker-compose ps
# Перезапуск
docker-compose restart
# Остановка
docker-compose down
# Полная пересборка
docker-compose down
docker-compose build --no-cache
docker-compose up -d
База данных
# Применить миграции
docker-compose exec app alembic upgrade head
# Откат миграции
docker-compose exec app alembic downgrade -1
# Создать новую миграцию
docker-compose exec app alembic revision --autogenerate -m "description"
Backup
# Backup базы данных
cp /root/telegram-ai-moderation/data/moderation.db \
/root/telegram-ai-moderation/data/moderation.db.backup.$(date +%Y%m%d)
# Автоматический backup (добавить в cron)
0 3 * * * cp /root/telegram-ai-moderation/data/moderation.db \
/root/telegram-ai-moderation/data/moderation.db.backup.$(date +\%Y\%m\%d)
Безопасность
Рекомендации для production:
- Измените пароль администратора!
python3 -m app.utils.create_admin - Настройте HTTPS (nginx или traefik)
- Ограничьте доступ к портам
ufw allow 80/tcp ufw allow 443/tcp ufw deny 8000/tcp # закрыть прямой доступ - Регулярно обновляйте зависимости
- Настройте backup базы данных
- Мониторинг логов на подозрительную активность
Никогда не коммитьте .env файл в git!
API Documentation
Автоматическая документация API доступна по адресам:
- Swagger UI - /docs
- ReDoc - /redoc
Пример использования API:
# Получить токен
curl -X POST "http://localhost:8000/api/auth/login" \
-F "username=admin" \
-F "password=admin123"
# Использовать токен
curl -H "Authorization: Bearer TOKEN" \
"http://localhost:8000/api/dashboard/stats"
Полезные ссылки
- @BotFather - создание Telegram ботов
- @userinfobot - получение User ID
- OpenAI Platform - API ключи
- Telegram Bot API - документация
- API Documentation - Swagger UI