sarah
64b2a95d57
- Creates data/system-prompt.txt with default SchrottBot personality - Ensures persistent directory exists - Group prompt is empty by default (no preset) - Can be customized per group via /ai setup Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
165 lines
3.8 KiB
Markdown
165 lines
3.8 KiB
Markdown
# Ulfbot
|
|
|
|
Ein Telegram-Bot, der mithilfe von Markov Chains neue Sätze aus vorherigen Nachrichten generiert. Optional mit KI/LLM-Integration.
|
|
|
|
## Features
|
|
|
|
- Lernt von allen Text-Nachrichten in einer Gruppe
|
|
- Generiert grammatikalisch sinnvolle Sätze mit Trigrammen
|
|
- Antwortet bei Reply, Erwähnung (@username) oder zufällig
|
|
- Pro-Chat-Wahrscheinlichkeit einstellbar (Admins)
|
|
- **KI/LLM-Integration** (OpenAI, Ollama, OpenRouter, etc.)
|
|
- Persistente SQLite-Datenbank
|
|
- Docker-Support
|
|
|
|
## Schnellstart
|
|
|
|
### Mit Docker (empfohlen)
|
|
|
|
```bash
|
|
# Repository klonen
|
|
git clone <repo-url>
|
|
cd ulfbot
|
|
|
|
# .env erstellen
|
|
cp .env.example .env
|
|
# BOT_TOKEN in .env eintragen
|
|
|
|
# Bauen und starten
|
|
npm run build
|
|
docker compose up -d --build
|
|
```
|
|
|
|
### Ohne Docker
|
|
|
|
```bash
|
|
# Abhängigkeiten installieren
|
|
npm install
|
|
|
|
# .env erstellen
|
|
cp .env.example .env
|
|
# BOT_TOKEN in .env eintragen
|
|
|
|
# Kompilieren
|
|
npm run build
|
|
|
|
# Starten
|
|
npm start
|
|
```
|
|
|
|
### Entwicklung
|
|
|
|
```bash
|
|
npm install
|
|
npm run dev # Hot-Reload aktiv
|
|
```
|
|
|
|
## Bot erstellen
|
|
|
|
1. [@BotFather](https://t.me/BotFather) auf Telegram öffnen
|
|
2. `/newbot` senden
|
|
3. Namen und Username wählen
|
|
4. Den erhaltenen Token in `.env` als `BOT_TOKEN` eintragen
|
|
|
|
## Befehle
|
|
|
|
### Markov (Standard)
|
|
|
|
| Befehl | Beschreibung |
|
|
|--------|--------------|
|
|
| `/start` | Begrüßung anzeigen |
|
|
| `/hilfe` | Hilfe anzeigen |
|
|
| `/prob` | Aktuelle Antwortwahrscheinlichkeit |
|
|
| `/setprob <0-100>` | Wahrscheinlichkeit setzen (Admins) |
|
|
| `/cleanup` | Datenbank bereinigen (Admins) |
|
|
|
|
### KI/LLM
|
|
|
|
| Befehl | Beschreibung |
|
|
|--------|--------------|
|
|
| `/ai setup` | KI-Setup starten (Admins, Privat-Chat) |
|
|
| `/ai status` | Aktuelle KI-Konfiguration |
|
|
| `/ai on/off` | KI aktivieren/deaktivieren |
|
|
| `/ask-ai [text]` | KI-Antwort generieren |
|
|
|
|
## Trigger für Antworten
|
|
|
|
### Markov (Standard)
|
|
- Reply auf Bot-Nachricht
|
|
- @Username-Erwähnung
|
|
- Zufällig (einstellbare Wahrscheinlichkeit)
|
|
|
|
### KI/LLM
|
|
- `/ask-ai [text]` Command
|
|
- Konfigurierbares Triggerwort (z.B. `ask-ai`)
|
|
- Zufällig (einstellbare Wahrscheinlichkeit)
|
|
|
|
## KI-Integration
|
|
|
|
### Setup
|
|
|
|
1. `/ai setup` in einer Gruppe ausführen
|
|
2. Der Bot sendet eine private Nachricht mit Setup-Wizard
|
|
3. Provider, API-Key, Model konfigurieren
|
|
4. API-Keys werden sicher gespeichert und maskiert angezeigt
|
|
|
|
### Unterstützte Provider
|
|
|
|
| Provider | API-Format |
|
|
|----------|------------|
|
|
| OpenAI | OpenAI API |
|
|
| Ollama | OpenAI-kompatibel (lokal) |
|
|
| OpenRouter | OpenAI-kompatibel |
|
|
| Custom | OpenAI-kompatibel |
|
|
|
|
### Umgebungsvariablen (.env)
|
|
|
|
```env
|
|
# Bot Token (erforderlich)
|
|
BOT_TOKEN=your_telegram_bot_token
|
|
|
|
# KI/LLM Settings (optional)
|
|
AI_DEFAULT_API_KEY=your_openai_api_key
|
|
AI_DEFAULT_BASE_URL=https://api.openai.com/v1
|
|
AI_DEFAULT_MODEL=gpt-4o-mini
|
|
AI_SYSTEM_PROMPT=Du bist ein freundlicher Chat-Bot...
|
|
```
|
|
|
|
### Prompt-System
|
|
|
|
- **Globaler System-Prompt** - Immer aktiv, geladen aus:
|
|
1. `data/system-prompt.txt` (persistent, wird automatisch erstellt)
|
|
2. Fallback: Default "SchrottBot"-Persönlichkeit
|
|
- **Gruppen-Prompt** (pro Chat) - Leer voreingestellt, kann `/ai setup` ergänzen
|
|
|
|
**system-prompt.txt:**
|
|
- Wird beim ersten Start automatisch in `data/` erstellt
|
|
- Enthält die UlfBot/SchrottBot-Persönlichkeit
|
|
- Kann bearbeitet werden, ohne den Container neu zu bauen
|
|
|
|
## Technisches
|
|
|
|
### Architektur
|
|
|
|
```
|
|
src/
|
|
├── index.ts # Bot-Logik, Commands, Setup-Wizard
|
|
├── markov.ts # Markov Chain Implementation
|
|
├── database.ts # SQLite Persistenz
|
|
└── ai.ts # OpenAI-kompatibler Client
|
|
```
|
|
|
|
- **Markov Chain** mit Trigrammen für bessere Grammatik
|
|
- **SQLite** für persistente Speicherung
|
|
- Pro Chat separate Daten/Lernkurve
|
|
|
|
### Datenbank-Cleanup
|
|
|
|
- Automatisch alle 24 Stunden
|
|
- Entfernt seltene Übergänge (nur einmal gesehen)
|
|
- Limitiert auf 10.000 Übergänge pro Chat
|
|
- Schützt neue Chats (min. 100 Übergänge nötig)
|
|
|
|
## Lizenz
|
|
|
|
ISC |