📱Telegram

Sprich mit deinen Sessions von deinem Handy aus. Harness Maxxing bringt ein eigenes Telegram-Gateway mit: Du musst kein zusätzliches Programm installieren.

• Ein Bot, nur mit deinem privaten Chat verknüpft.
• Ein Thread pro offener Session - der Telegram-Chat spiegelt die Seite Sessions - plus Crons (Berichte der Jobs), Alerts (Anmeldewarnungen) und Notifications (der Benachrichtigungs-Feed: Verkäufe, Bestellungen, deine Skripte … nach den Regeln, die du festlegst, vom Bot selbst gepostet, mit einem Button Ask Harness). Ein Thread heißt <project>/<topic> · <session title>, mit dem Emoji des Projekts davor, wenn es eines hat (Menü … des Projekts in Sessions -> Emoji festlegen…), z. B. 🛒 acme/blog · Launch plan. Wenn du das Emoji änderst, werden die Threads umbenannt.
• Ein Thread ist die Session selbst: Was du auf dem Handy schreibst, erscheint in der Web-Oberfläche und du kannst dort weitermachen, und umgekehrt.
• Schreibe im Hauptchat (oder erstelle einen Thread), um eine neue Session zu starten: Der Bot fragt, in welchem Topic.

Einrichtung (Einstellungen -> Telegram)

1. Öffne in Telegram @BotFather, sende /newbot, wähle einen Namen und einen Benutzernamen, der auf bot endet. Kopiere den Token, den du bekommst (123456789:AA...).
2. Öffne in BotFather die Einstellungen deines Bots und aktiviere Topics (Threads) für private Chats, damit jede offene Session ihren eigenen Thread bekommt. Ohne diese Option funktioniert alles im Hauptchat (mit /topic wählst du, mit welchem Topic er spricht).
3. Füge den Token in Einstellungen -> Telegram ein. Der Server prüft ihn.
4. Klicke auf Verknüpfen, öffne den Link t.me/<bot>?start=<code> auf deinem Handy und drücke Start. Der Code ist 15 Minuten gültig. Ab dann werden Nachrichten aus jedem anderen Chat ignoriert.
5. Klicke auf Threads synchronisieren (danach läuft es automatisch: siehe unten).
6. Wähle die Optionen: Cron-Berichte, Anmeldewarnungen, Anmeldung in zwei Schritten, Antwortmodus (Live-Fortschritt, die Standardeinstellung = eine Statusmeldung, die aktualisiert wird, während Claude arbeitet, mit seiner Aufgabenliste und jedem Schritt, am Ende zu einer Zusammenfassung eingeklappt; Endantwort = nur die Antwort). Drücke Test senden.

Threads = offene Sessions

Gespiegelte Sessions: die, mit denen du sprichst (nicht die von geplanten Jobs gestarteten - ihre Berichte gehen an Crons), nicht archiviert, in den letzten 30 Tagen aktiv (Einstellungen -> Telegram -> Thread behalten für: 7, 14, 30 oder 90 Tage), höchstens 50. Eine ältere Session bekommt ihren Thread einfach zurück, sobald sie wieder benutzt wird. Die Synchronisierung läuft einige Sekunden nach jeder Änderung und alle 10 Minuten; du musst nichts planen. Wenn Telegram das Löschen eines Threads kurzzeitig verweigert (zu viele Anfragen, keine Verbindung), löscht die nächste Synchronisierung ihn. Wenn du eine Session umbenennst, wird ihr Thread umbenannt: Telegram zeigt im Thread eine kleine Zeile „Topic umbenannt“ an.

Benutzung

• Schreibe im Thread einer Session: Claude antwortet in diesem Thread. Während es arbeitet, siehst du „schreibt …“ und bei längeren Aufgaben die Live-Statusmeldung.
• Sende Fotos und Dateien: Sie werden in <topic>/attachments/telegram/YYYY-MM/ gespeichert und zusammen mit deiner Bildunterschrift an Claude weitergegeben.
• Befehle:

• Die Glocke einer Session (Web-Oberfläche, neben ihrem Titel): Bei ausgeschalteter Spiegelung (Standard) sendet sie eine kurze Meldung „fertig“ in den Thread der Session, wenn ein Durchgang endet; bei eingeschalteter Spiegelung lässt sie die gespiegelten Antworten klingeln.

Anmeldung in zwei Schritten

Einstellungen -> Telegram (oder Einstellungen -> Sicherheit) -> Anmeldung in zwei Schritten: Nach dem richtigen Passwort wartet ein noch nicht vertrauenswürdiger Browser auf deine Freigabe in Telegram. Der Thread Alerts bekommt eine Nachricht mit der IP, dem Browser, einem 6-stelligen Code und zwei Buttons:

• Erlauben: Die Anmeldeseite öffnet sich von selbst;
• Ablehnen: Die Anmeldung wird abgelehnt - und da das richtige Passwort eingegeben wurde, ändere es (Einstellungen -> Sicherheit).

Wenn die Buttons nicht reagieren, gib den Code aus der Nachricht auf der Anmeldeseite ein. Eine Anfrage läuft nach 2 Minuten ab; 5 falsche Codes brechen sie ab, und nach 20 falschen Codes innerhalb einer Stunde auf dem ganzen Server werden Codes für diese Stunde pausiert (der Button Erlauben funktioniert weiterhin) - wer das Passwort kennt, kann also nicht von vielen Adressen aus Codes ausprobieren. Eine erneut geöffnete Anmeldeseite ersetzt ihre vorherige Anfrage. Diesem Browser 30 Tage lang vertrauen (standardmäßig angehakt) überspringt den zweiten Schritt in diesem Browser; Vertrauenswürdige Browser vergessen sorgt dafür, dass jeder andere Browser wieder nachfragt (eine Passwortänderung bewirkt das ebenfalls). Das Ändern des Passworts, das Vergessen von Browsern oder das Ausschalten der Anmeldung in zwei Schritten bricht außerdem jede noch wartende Anfrage ab, auch eine, die du versehentlich erlaubt hast.

Beim Einschalten wird eine erste Anfrage gesendet: Sie wird erst aktiviert, wenn du sie freigegeben hast, sodass ein Bot, der nicht antwortet, dich nicht aussperren kann. Wenn du die Verknüpfung mit Telegram aufhebst, wird sie ausgeschaltet.

Telegram antwortet nicht (Bot gelöscht, Telegram gestört, Handy verloren): auf dem Server, per SSH,

maxxing 2fa off             # password only again (every trusted browser is forgotten)
maxxing 2fa status          # on / off

Fehlerbehebung

maxxing telegram status     # bot, chat, threads, settings, last error
maxxing telegram test       # sends a test message

Um die Verbindung zu trennen: Einstellungen -> Telegram -> Verknüpfung aufheben (vergisst den Token und den Chat).