DOKU & FAQ

THE GRIND CLERK ist dein Tracking per Telegram-Chat. Du schreibst wie im normalen Chat, der Bot erkennt Ernährung, Training und Gewicht automatisch und erstellt tägliche sowie wöchentliche Auswertungen.

Schnellstart in 4 Schritten

So läuft der Input im Alltag

Was das Tool kann

Ernährungstracking

Kalorien + Makros pro Eintrag, inklusive Tagesstand in kompakter Form: Kal in / Kal Ziel · P · K · F.

Trainingstracking

Übungen, Dauer, Belastung und Energieverbrauch aus Text/Voice/Bild werden als Training gespeichert.

Wiederkehrende Mahlzeiten

Einträge können per natürlicher Sprache wiederholt werden, z.B. "Frühstück wie gestern".

Gewicht & Trend

Gewicht per Chat anpassen. Der Bot antwortet kurz und zeigt Trend, wenn mehrere Werte vorliegen.

Daily Report

Tägliche Zusammenfassung mit Ernährung, Training und Kernwerten für den Tag.

Weekly Report

Wöchentliche Trends für Kalorien, Makros, Trainingsvolumen und Gewichtsentwicklung.

Eingaben, die funktionieren

Text Sprachnachricht Essensfoto Trainingsscreenshot Kurze Kommandos
Beispiele Ernährung

"2 Eier, Haferflocken mit Banane und Kaffee"

"Mittag wie gestern"

"Post-Workout Bowl" + Foto

Beispiele Training

"Push: Bankdrücken 4x8 80kg, Schrägbank 3x10, Dips 3x12"

"War 45 Min schwimmen, moderat"

Screenshot aus Garmin/Watch/Health-App mit Dauer, Puls oder kcal

Beispiele Gewicht

"Gewicht 82,4 kg"

"Heute 81.9kg"

"Mein Gewicht ist jetzt 83"

Telegram Commands

Du kannst fast alles einfach per natürlicher Nachricht loggen. Die Commands sind für Übersicht, Reports und Verwaltung.

Standard-Commands (alle Nutzer)

Command Funktion Beispiel
/start Startet den Bot und führt bei Bedarf ins Onboarding zurück. /start
/help Zeigt die Kurz-Hilfe mit wichtigsten Commands und Eingabeformen. /help
/today Tagesübersicht mit aktuellem Kalorien- und Makrostand plus Anzahl Einträge. /today
/report <YYYY-MM-DD> Generiert/lädt den Tagesreport für ein Datum und sendet Summary + Datei. /report 2026-02-19
/weekly Wochenbericht für die letzte abgeschlossene Woche (Mo-So). /weekly
/weekly <YYYY-MM-DD> Wochenbericht für die Woche des angegebenen Datums. /weekly 2026-02-16
/profile Zeigt dein aktuelles Profil aus dem Onboarding. /profile
/profile edit Startet das Profil-Onboarding neu, um Daten strukturiert zu ändern. /profile edit
/delete Listet heutige Einträge nummeriert, damit du gezielt löschen kannst. /delete
/delete <Nummer> Löscht den Eintrag anhand der zuletzt angezeigten Liste. /delete 2
/delete last Löscht den zuletzt erfassten Eintrag von heute. /delete last
/delete account Startet die komplette Account-Löschung (Profil, Einträge, Reports, Gewichtsdaten). Danach ist eine Bestätigung nötig. /delete account
/delete account confirm
/theme Sendet die THE GRIND CLERK Theme-Datei für Telegram. /theme
/ziel Zeigt deine aktuellen Profilwerte und Ziele. Mit /ziel <feld> <wert> einzelne Angaben ändern. /ziel
/ziel gewicht 80
/ziel ziel Abnehmen
/ziel zielgewicht 75

Wichtig zu Gewicht und Commands

Für Gewicht brauchst du keinen eigenen Command. Eine natürliche Nachricht reicht, z.B. "Gewicht 82,4 kg". Der Wert wird gespeichert und in den Weekly-Trend übernommen.

Profil und Ziele anpassen

Mit /ziel siehst du dein aktuelles Profil. Einzelne Felder änderst du direkt: /ziel gewicht 80, /ziel ziel Abnehmen oder /ziel zielgewicht 75. Verfügbare Felder: geschlecht, alter, größe, gewicht, aktivität, sport, ziel, zielgewicht, über, notizen. Wenn du ein Zielgewicht setzt, trackt der Clerk deinen Fortschritt automatisch in den Daily- und Weekly-Reports.

FAQ

Wie wird ein Trainingsscreenshot erkannt?

Der Bot prüft zuerst, ob das Bild eher Training oder Essen zeigt. Bei erkannten Trainingsdaten werden Metriken wie Dauer, Herzfrequenz oder Kalorien übernommen und als Training geloggt.

Warum wird ein Screenshot manchmal nicht erkannt?

Wenn Werte im Bild abgeschnitten, zu klein oder durch Overlays verdeckt sind, kann die Extraktion fehlschlagen. Am besten ein klares Bild mit sichtbaren Kernwerten (Zeit, Distanz, Puls oder kcal) senden.

Kann ich Einträge korrigieren?

Ja. Du kannst per /delete gezielt entfernen und danach neu loggen, oder direkt eine korrigierte Nachricht schicken (z.B. andere Menge, andere Übung, neues Gewicht).

Wie fließt das Gewicht in die Wochenreports ein?

Jeder Gewichts-Chat-Eintrag wird als Zeitreihe gespeichert. Im Weekly wird daraus ein kompakter Wochen-Trend mit Richtung und Veränderung erzeugt. Wenn du ein Zielgewicht gesetzt hast (/ziel zielgewicht 80), zeigen Daily- und Weekly-Reports zusätzlich den Abstand zum Ziel.

Kann ich mein Profil nachträglich ändern?

Ja. Mit /ziel siehst du alle aktuellen Werte. Einzelne Felder änderst du mit /ziel <feld> <wert> — z.B. /ziel ziel Abnehmen oder /ziel sport Calisthenics. Kein erneutes Onboarding nötig.

Ist das medizinische Beratung?

Nein. THE GRIND CLERK ist kein Medizinprodukt und ersetzt keine ärztliche Beratung.

Direkt starten

Bot öffnen, erste Mahlzeit oder erstes Training schicken, fertig.

Jetzt zu @TheGrindClerk_bot