📚 Dokumentation
Jede Funktion, jede Einstellung.
Alles, was die App tut, und jede Einstellung, die sie hat — geschrieben für die Version, die du gerade verwendest. Von der Menüleiste bis zum Fähigkeiten-Register: das ist das komplette Handbuch.
Auf dieser Seite
Schnellstart Die Menüleisten-App Einstellungen, erklärt Modell-Tab Telegram-Tab Pro-Bot-Seiten App-Tab Fähigkeiten & Funktionen Fähigkeiten-Register Updates Daten & Datenschutz FehlerbehebungSchnellstart
- Installieren. Lade die .dmg herunter und ziehe Telebot AI in Programme. Der Build ist noch nicht notarisiert; wenn macOS eine Warnung zeigt, klicke mit rechts (Control-Klick) auf die App und wähle Öffnen — einmal.
- Einen Bot erstellen. Schreibe @BotFather auf Telegram, führe /newbot aus und kopiere den Token. Ein Token pro Bot — du kannst mehrere betreiben.
- Token hinzufügen. Öffne Telebot AI aus der Menüleiste, öffne die Einstellungen und füge den Token in das Token-Feld eines Bots ein. Er wird gespeichert, sobald du tippst — es gibt keinen Speichern-Button.
- Ein Gehirn verbinden. Setze im Modell-Tab die Server-URL (http://localhost:11234 für mlx-serve, http://localhost:11434 für Ollama) und den Modellnamen, oder nutze eine beliebige OpenAI-kompatible Cloud-API. Drücke Testen, um die Verbindung zu prüfen.
- Bot starten. Zurück in der Menüleiste wählst du Bot starten. Schreib deinem Bot auf Telegram — ab diesem Moment antwortet er.
Neu bei lokalen Modellen? Lies den Guide — er behandelt mlx-serve, Ollama und LM Studio und wie viel RAM jedes Modell braucht.
Die Menüleisten-App
Telebot AI lebt in deiner Menüleiste (⌘-Symbol). Das Menü bietet dir:
- Starten / Stoppen / Neu starten — pro Bot oder alle auf einmal. Bots laufen als LaunchAgents: immer an, nie im Weg.
- Einstellungen öffnen — das Einstellungsfenster.
- Logs — verfolge das Bot-Log, um zu sehen, was er tut, oder ein Problem zu debuggen.
- Beenden — stoppt alles (und deaktiviert die LaunchAgents, bis du wieder startest).
Einstellungen, erklärt
Das Einstellungsfenster hat eine Seitenleiste mit zwei Arten von Seiten:
- Standardwerte — Modell, Telegram, App, Fähigkeiten & Funktionen, Fähigkeiten-Register, Über, Updates. Werte, die jeder Bot erbt.
- Bots — eine Seite pro Bot. Jedes Feld zeigt, was dieser Bot tatsächlich nutzt: Ein Wert überschreibt den Standard, ein leeres Feld erbt ihn (der Erklärtext unter jeder Zeile sagt es). Deshalb gibt es keine "Global verwenden"-Checkboxen — ein leeres Feld ist "global verwenden".
Alles wird automatisch gespeichert, während du tippst oder umschaltest. Die Einstellungen liegen in ~/.mlx-serve/config.json.
Standardwerte → Modell
| Einstellung | Was sie tut |
|---|---|
| Server-URL | Der OpenAI-kompatible Endpunkt. Lokale Server brauchen keinen Key. |
| API-Schlüssel | Für lokale Server leer lassen (mlx-serve, Ollama, LM Studio). Das Augen-Symbol zeigt oder verbirgt ihn. |
| Modellname | Welches Modell auf diesem Server, z. B. deepseek-v4-flash-free. |
| Testen | Prüft die Verbindung mit den aktuellen Werten — nützlich, bevor du etwas speicherst. |
| Backup-Modelle | Werden der Reihe nach versucht, wenn das primäre ausfällt oder drosselt. Jedes hat eigenen Spitznamen, URL, Key und Modell, plus Testen, Umsortieren und Entfernen. Hinzufügen ist gesperrt, bis die letzte Zeile vollständig ist. |
Standardwerte → Telegram
| Einstellung | Was sie tut |
|---|---|
| Erlaubte Chat-IDs | Kommagetrennte Benutzer-/Gruppen-IDs, die mit dem Bot sprechen dürfen. Leer = jeder. |
| Zeit des täglichen Briefings | Wann der Bot sein tägliches Briefing sendet — 24-Stunden-Stunde/Minute-Dropdowns (z. B. 08:00). |
| Briefing-Aufforderung | Was das Briefing abdecken soll — z. B. "Wetter, meine heutigen Erinnerungen und alle Preisalarme". |
| Max. Antwort-Tokens | Sicherheitsdeckel für Antworten; lange Antworten werden auf mehrere Nachrichten aufgeteilt. |
| Kontext pro Chat | Wie viele letzte Nachrichten der Bot pro Chat als Kontext hält. |
| Erinnerungen pro Benutzer | Langzeiterinnerungen, die pro Benutzer und beantworteter Nachricht abgerufen werden. |
| Gedächtnis-Datenbankgröße (pro Benutzer) | Maximal gespeicherte Erinnerungen pro Benutzer; darüber hinaus werden die ältesten entfernt. |
| Tokens für Recherche-Berichte | Budget für /research- und /insiders-Berichte. |
| API-Timeout (s) | Sekunden, bevor ein langsamer Anbieter aufgegeben wird — kostenlose Warteschlangen können über eine Minute dauern. |
| Soul-Datei | Die Persönlichkeit, mit der die Bots laufen. .md-Dateien in diesem Ordner (soul*.md, *persona*.md) erscheinen im Persönlichkeits-Dropdown jedes Bots. |
| Bot-Triggerwörter | Kommagetrennte Wörter, die den Bot in Gruppen antworten lassen (zusätzlich zu @Erwähnung, Antwort oder Befehl) — z. B. "momo, jarvis, hey bot". |
| Video-/Audio-Clip-Triggerwörter | Wörter, die den Bot ein angehängtes Video oder Audio als Clip greifen lassen — z. B. "clip this, save this". |
Pro-Bot-Seiten
Jeder Bot in der Seitenleiste hat seine eigene Seite. Leere Felder erben die Standardwerte; der Erklärtext unter jeder Zeile sagt, was geerbt wird.
| Einstellung | Was sie tut |
|---|---|
| Token | Der @BotFather-Token des Bots (Augen-Symbol zum Anzeigen). Eine Änderung benennt den Seiteneintrag des Bots um. |
| Spitzname | Wird in Status, Logs und Seitenleiste verwendet — z. B. "Trading". |
| Erlaubte Chat-IDs / Triggerwörter / Clip-Wörter | Die Überschreibungen dieses Bots für die jeweiligen Standardwerte. |
| Server-URL, API-Schlüssel, Modell | Das Dropdown bietet die unter Standardwerte → Modell konfigurierten Anbieter plus beliebige eigene Werte. Eigene Backup-Modelle können pro Bot hinzugefügt werden. |
| Zeit des täglichen Briefings / Briefing-Aufforderung | Bot-eigenes Briefing mit einem "Global verwenden"-Button, der die Überschreibung löscht. |
| Modus | Forscher, Assistent, Programmierer, Koch oder Keine — leer verwendet den Standardmodus. |
| Soul-Datei | Die Persönlichkeits-Überschreibung dieses Bots, gewählt aus den auf der Platte gefundenen Soul-/Persona-Dateien. |
| Fähigkeiten | Öffnet das Fähigkeiten-Blatt des Bots — Fähigkeiten für diesen Bot zusätzlich zu den Standardwerten deaktivieren oder auf Standard zurücksetzen. |
Standardwerte → App
| Einstellung | Was sie tut |
|---|---|
| Im Dock anzeigen | Ob die Menüleisten-App auch im Dock erscheint. |
| Beim Anmelden starten | Telebot AI bei der Anmeldung starten. |
| Datenordner | Wo Konfiguration, Gedächtnis, Erinnerungen und Logs leben (Standard: ~/.mlx-serve). |
| Log öffnen / Datenordner öffnen | Direkt zur Logdatei oder zum Datenordner im Finder springen. |
| Einstellungen exportieren | Speichert die vollständige Konfiguration (inkl. API-Keys) in eine Datei — für Backups oder den Mac-Wechsel. |
| Einstellungen importieren | Lädt eine Konfigurationsdatei und wendet sie sofort an. |
Fähigkeiten & Funktionen
Die Fähigkeiten des Bots sind modellgesteuerte Skills — klare Anweisungen, die das Modell mit seinen Tools befolgt, damit du in natürlicher Sprache beschreibst, was du willst, statt Befehle auswendig zu lernen. Jede Gruppe hat einen Master-Schalter; einzelne Fähigkeiten lassen sich an- und ausschalten.
| Gruppe | Fähigkeiten | Sag zum Beispiel |
|---|---|---|
| Recherche | stock-research, stocks-crypto, insider-trading, currency | "recherchiere TSLA", "Preis von BTC", "Insider-Trades für AAPL", "wie viel sind 50 USD in CAD?" |
| Täglich | briefing, digest, reminders, habits, review, pomodoro, bookmarks, expenses | "/briefing", "fasse diesen Chat zusammen", "erinnere mich um 17 Uhr", "heutige Gewohnheit erledigt", "wöchentlicher Rückblick", "/pomodoro 25", "25 Mittagessen notieren" |
| Medien | media, voice, translation, feeds | "analysiere dieses Video", "lies das laut vor", "übersetze das ins Deutsche", "was gibt's Neues in meinen Feeds?" |
| Tools | memory | "worüber haben wir gestern gesprochen?" |
| Aus dem Register | Fähigkeiten, die du aus dem Register installierst | — |
Fähigkeiten-Register
Der Register-Tab lässt dich fertige Fähigkeiten aus dem öffentlichen anthropics/skills-Katalog installieren — PDF- und Dokumentbearbeitung, Tabellenkalkulationen, Präsentationen, Web-App-Tests, MCP-Server-Bau, Kunst und mehr. Lade den Katalog, wähle eine Fähigkeit, und sie erscheint wie jede andere im Tab Fähigkeiten & Funktionen.
Updates
Der Updates-Tab vergleicht das Manifest der Landingpage mit deiner installierten Version und zeigt die neueste Version mit Download-Link. Die Prüfung ist leise — offline oder unerreichbar bedeutet einfach "auf dem neuesten Stand". Zum Aktualisieren: die neue .dmg herunterladen und in Programme über die alte App ziehen. Einstellungen, Bots und Erinnerungen leben außerhalb der App und bleiben unangetastet.
Daten & Datenschutz
- Wo die Dinge liegen: Konfiguration, Chat-Gedächtnis, Erinnerungen, Fähigkeiten und Logs bleiben alle in deinem Datenordner (Standard: ~/.mlx-serve).
- Was deinen Mac verlässt: die Telegram-API selbst, der Modellserver, auf den du den Bot zeigst, und anonyme Nutzungsstatistiken (App-Starts und Menüaktionen). Kein Chat-Inhalt, keine Tokens, keine persönlichen Daten.
Fehlerbehebung
- "Apple kann nicht prüfen, ob die App schädliche Software enthält" — normal: Rechtsklick (Control-Klick) auf die App in Programme → Öffnen → nochmal Öffnen. Einmal, dann läuft sie normal.
- Der Bot antwortet nicht. Öffne Einstellungen → die Seite des Bots: stimmt der Token? Dann Standardwerte → Modell → Testen des Anbieters. Danach im Log nachsehen (Menüleiste → Logs oder App-Tab → Log öffnen).
- Antworten sind langsam oder der Bot schweigt. Kostenlose Anbieter können über eine Minute brauchen — erhöhe das API-Timeout und füge Backup-Modelle hinzu, damit der Bot umschaltet, wenn das primäre drosselt.
- Lokaler Server antwortet nicht. Stelle sicher, dass der Server wirklich läuft (mlx-serve, Ollama…), bevor du im Modell-Tab testest.
- Updates sagen seltsam "auf dem neuesten Stand". Die Prüfung ist absichtlich leise — wenn das Manifest nicht erreichbar ist, meldet sie neuesten Stand.
- Etwas anderes? Feedback senden — jede Nachricht landet im Telegram des Entwicklers und bekommt eine echte Antwort.
Telebot AI herunterladen · Gefällt's dir? Spendier mir einen Kaffee ☕