blackdark
Automatisierung

Dein KI-Agent rund um die Uhr auf einer TV-Box für 30 €: Claude + Termux + Telegram-Bot (Schritt für Schritt)

So machst du aus einer Android-TV-Box (oder einem alten Handy) einen KI-Agenten, der 24/7 läuft: Termux und Termux:Boot aus F-Droid, Wake Lock, die Claude-API und ein privater Telegram-Bot, der nur dir antwortet. Mit Prompt, Code und Grenzen.

Von Aktualisiert am 6 Min. Lesezeit
Direkt zum Prompt

Ehrlicher Hinweis: NICHT offizieller Ablauf, von uns nicht getestet

Weder Anthropic noch Google unterstützen es, einen Agenten mit Termux auf einer TV-Box laufen zu lassen. Wir haben es nicht von Anfang bis Ende auf einer bestimmten Box getestet: Der Guide kombiniert Bausteine, die es gibt und die einzeln funktionieren (Termux, Termux:Boot, Wake Lock, die Claude-API und Telegram-Bots). Jede China-Box ist eine Welt für sich, und bei deiner kann sich ein Schritt unterscheiden. Geh es in Ruhe an, mit einer Box, an der du ruhig herumbasteln darfst.

Eine Android-TV-Box für 30 € (oder ein altes Handy aus der Schublade) kann als „Rechner, der 24/7 läuft“ für einen KI-Agenten dienen. Die Box führt nur aus; Claude denkt in der Cloud. Du sprichst über einen privaten Telegram-Bot mit ihm, der nur dir antwortet, auch wenn dein Laptop aus ist.

So funktioniert es

  1. Du schreibst dem Bot

    Über Telegram, auf deinem Handy, wo immer du bist.

  2. Die Box holt die Nachricht ab

    Termux fragt alle paar Sekunden bei Telegram nach (Long Polling, ohne Ports zu öffnen).

  3. Claude denkt in der Cloud

    Die Box schickt die Aufgabe an die Claude-API und bekommt die Antwort.

  4. Die Antwort kommt bei dir an

    Der Bot schickt sie dir per Telegram zurück. Nur an deine chat_id.

Wofür es taugt (und wofür nicht)

JaNein
Texte zusammenfassen, formulieren, Fragen beantwortenNichts Schweres: Sie hat 2 GB RAM
Geplante Benachrichtigungen jeden MorgenNichts, was einen echten Browser braucht
Kleine, wiederkehrende SkripteEinen Mac Mini ersetzen: Sie ist viel, viel langsamer

Was du brauchst

  • Eine eigene Android-TV-Box: etwa X96Q, H96 oder ähnlich, ARM-Chip mit 4 Kernen, 2 GB RAM und Android 7 oder höher (besser 9+). Etwa 25–35 €. Nicht den Receiver deines Anbieters: Der ist meist gesperrt, gehört ihnen, und daran herumzubasteln kann gegen deinen Vertrag verstoßen.
  • WLAN oder Kabel sowie eine USB-Tastatur/-Maus (oder die Fernbedienungs-App auf dem Handy) für die ersten Schritte.
  • Ein Konto in der Claude-Konsole (platform.claude.com) mit Guthaben. Die API wird nach Nutzung abgerechnet; das ist nicht das Pro-Abo.
  • Telegram auf dem Handy.

Schritt 0: der Prompt (Foto + Claude)

Mach ein Foto von der Box (und vom Etikett auf der Unterseite, falls dort ein Modell steht) und füg es mit diesem Prompt in claude.ai ein. Claude führt dich dann passend zu deiner Box durch:

Prompt · Mach aus meiner TV-Box einen 24/7-Agenten
Das ist meine Android-TV-Box (Foto im Anhang). Ich will daraus einen Server machen, der rund um die Uhr einen KI-Agenten ausführt, auch wenn mein Laptop aus ist. Plan:
1) Bestimme das Modell, den Chip (ARM-Architektur, 32 oder 64 Bit) und die wahrscheinliche Android-Version. Wenn du es nicht sicher weißt, sag mir, wie ich es in den Einstellungen oder mit "uname -m" und "getprop ro.build.version.release" prüfe.
2) Führ mich Schritt für Schritt durch die Installation von Termux und Termux:Boot aus F-Droid (nicht Google Play) auf GENAU diesem Gerät, mit den nötigen Android-Einstellungen (unbekannte Quellen, Akku-Optimierung für Termux abschalten).
3) Sorg dafür, dass Android den Prozess nicht beendet: termux-wake-lock und Autostart mit Termux:Boot.
4) Schreib mir einen Telegram-Bot in Python OHNE externe Abhängigkeiten (nur Standardbibliothek), der:
 - Long Polling nutzt (ohne Ports zu öffnen),
 - NUR auf meine chat_id antwortet (liest sie aus einer Umgebungsvariable) und alle anderen ignoriert,
 - meine Nachrichten an die Claude-API schickt und mir die Antwort zurückgibt,
 - die Schlüssel aus Umgebungsvariablen liest. Bitte mich NIE, dir meine Schlüssel in diesen Chat zu kopieren.
5) Sag mir, wie ich es teste und wie ich die Logs ansehe, wenn es scheitert.
Geh Schritt für Schritt vor: Gib mir einen Schritt, warte, bis ich „erledigt“ oder die Fehlermeldung schreibe, und mach dann weiter.

Unten findest du denselben Weg ausgeschrieben, falls du es lieber von Hand machst.

Schritt 1: Termux und Termux:Boot aus F-Droid

  1. Öffne auf der Box den Browser und lade F-Droid von f-droid.org herunter. Erlaube die Installation von Apps aus „unbekannten Quellen“, wenn du gefragt wirst.
  2. Installiere über F-Droid Termux und Termux:Boot. Beide aus derselben Quelle: Termux:Boot führt Skripte nur aus, wenn es mit demselben Schlüssel signiert ist wie Termux, und jeder Store signiert mit einem anderen Schlüssel.
  3. Öffne Termux:Boot einmal (nur öffnen). So erlaubt Android den Start beim Einschalten.
  4. Android-Einstellungen → Apps → Termux → Akku → Nicht eingeschränkt / nicht optimieren.

Schritt 2: Linux in Termux vorbereiten

Öffne Termux und gib ein:

pkg update && pkg upgrade -y
pkg install -y python
uname -m          # aarch64 = 64-Bit-ARM (der Normalfall)

Schritt 3: der Telegram-Bot

  1. Sprich in Telegram mit @BotFather → /newbot → gib ihm einen Namen. Du bekommst einen Token: Teile ihn mit niemandem.
  2. Deine chat_id: Schreib deinem neuen Bot irgendetwas und öffne im Browser https://api.telegram.org/bot<DEIN_TOKEN>/getUpdates. Such nach "chat":{"id":123456789: Diese Zahl ist deine chat_id.

Schritt 4: die Schlüssel, raus aus dem Code und raus aus dem Chat

Erstelle in der Claude-Konsole unter API keys einen Schlüssel. Dann in Termux:

nano ~/.agente.env

Füg das mit deinen Werten ein:

export ANTHROPIC_API_KEY="sk-ant-..."
export TELEGRAM_TOKEN="123456:ABC..."
export CHAT_ID="123456789"
export MODELO="hier-die-modell-id-eintragen"

Die Modell-ID kopierst du aus der offiziellen Modellliste (ein Haiku ist für kleine Aufgaben am günstigsten). Speichere (Strg+O, Enter, Strg+X) und schütze die Datei:

chmod 600 ~/.agente.env

Setz ein Ausgabenlimit

Leg in der Claude-Konsole unter Limits eine monatliche Ausgabengrenze fest. So gibt es keinen Schreck, selbst wenn etwas schiefläuft.

Schritt 5: der Agent (Python ohne Abhängigkeiten)

nano ~/agente.py
import json, os, time, urllib.request

TG = f"https://api.telegram.org/bot{os.environ['TELEGRAM_TOKEN']}"
YO = int(os.environ["CHAT_ID"])
KEY, MODELO = os.environ["ANTHROPIC_API_KEY"], os.environ["MODELO"]

def post(url, data, headers=None):
    req = urllib.request.Request(url, json.dumps(data).encode(), {"Content-Type": "application/json", **(headers or {})})
    with urllib.request.urlopen(req, timeout=120) as r:
        return json.load(r)

def claude(texto):
    r = post("https://api.anthropic.com/v1/messages",
             {"model": MODELO, "max_tokens": 1500,
              "system": "Du bist mein Assistent. Klare und kurze Antworten, auf Deutsch.",
              "messages": [{"role": "user", "content": texto}]},
             {"x-api-key": KEY, "anthropic-version": "2023-06-01"})
    return "".join(b.get("text", "") for b in r.get("content", [])) or "(keine Antwort)"

offset = 0
while True:
    try:
        upd = post(f"{TG}/getUpdates", {"offset": offset, "timeout": 50})
        for u in upd.get("result", []):
            offset = u["update_id"] + 1
            msg = u.get("message") or {}
            if msg.get("chat", {}).get("id") != YO or "text" not in msg:
                continue  # antwortet nur dir
            post(f"{TG}/sendMessage", {"chat_id": YO, "text": "Erhalten. Ich kümmere mich darum."})
            post(f"{TG}/sendMessage", {"chat_id": YO, "text": claude(msg["text"])[:4000]})
    except Exception as e:
        print("Fehler:", e)
        time.sleep(10)

Test es:

source ~/.agente.env && python ~/agente.py

Schreib deinem Bot über Telegram. Wenn er antwortet, funktioniert es. Mit Strg+C stoppst du ihn.

Schritt 6: Damit sie nicht einschläft und von selbst startet

mkdir -p ~/.termux/boot
nano ~/.termux/boot/agente.sh
#!/data/data/com.termux/files/usr/bin/sh
termux-wake-lock
. ~/.agente.env
nohup python ~/agente.py >> ~/agente.log 2>&1 &
chmod +x ~/.termux/boot/agente.sh

Starte die Box neu. Ohne etwas zu öffnen, schreib dem Bot: Er sollte antworten. Wenn nicht, schau mit cat ~/agente.log ins Log. termux-wake-lock hinterlässt eine dauerhafte Termux-Benachrichtigung: Das ist normal, genau das verhindert, dass Android es beendet.

Ideen für erste Aufgaben

  • „Fass mir diesen Text zusammen, den ich dir einfüge.“
  • „Schreib mir 3 Versionen dieser Nachricht an einen Kunden.“
  • „Schreib mir das Skript für ein Reel über X.“
  • Benachrichtigungen: Installiere cronie (pkg install cronie) und plane ein Skript, das jeden Morgen läuft und dir das Ergebnis an den Bot schickt.

Grenzen und Sicherheit (lies das)

  • Nicht offiziell und von uns nicht von Anfang bis Ende getestet. Wenn ein Schritt auf deiner Box scheitert, gib Claude die Fehlermeldung.
  • Claude Code (das Terminal-Tool) wird unter Termux ebenfalls nicht offiziell unterstützt; deshalb nutzt dieser Guide die API direkt.
  • Kosten: Jede Nachricht verbraucht API-Token. Ausgabenlimit gesetzt = Ruhe.
  • Schlüssel: nur in ~/.agente.env, auf der Box. Nie im Chat mit Claude, nie in Screenshots, nie auf GitHub.
  • Datenschutz: Was du dem Bot schickst, läuft über Telegram und die Anthropic-API. Gib ihm keine sensiblen Daten.
  • Wenn du die Box verkaufst oder verschenkst: Lösch Termux (oder setz sie auf Werkseinstellungen zurück) und widerrufe den API-Schlüssel und den Bot-Token.

Checkliste

  • Eigene TV-Box (oder altes Handy) mit Android 7 oder höher.
  • Termux und Termux:Boot aus F-Droid installiert, Termux:Boot einmal geöffnet.
  • Termux ohne Akku-Optimierung.
  • Bot mit @BotFather erstellt und deine chat_id notiert.
  • Schlüssel in ~/.agente.env mit chmod 600 und Ausgabenlimit gesetzt.
  • Der Bot antwortet dir nach einem Neustart der Box.

FAQ

Nein. Weder Anthropic noch Google unterstützen es, einen Agenten mit Termux auf einer TV-Box laufen zu lassen, und wir haben es nicht von Anfang bis Ende auf einer bestimmten Box getestet. Jede Box ist anders: Wenn ein Schritt scheitert, gib Claude die Fehlermeldung.

Die Box etwa 25–35 €. Termux, Termux:Boot und Telegram sind kostenlos. Die Claude-API wird nach Nutzung (pro Token) abgerechnet und ist unabhängig vom Pro-Abo. Mit kurzen Nachrichten und einem kleinen Modell bleiben die Kosten niedrig, aber setz in der Konsole ein Limit.

Ja, genau wie die Box: mit Android 7 oder höher und am Strom. Schalte für Termux die Akku-Optimierung ab.

Nein. Der ist meist gesperrt, gehört dem Anbieter, und daran herumzubasteln kann gegen deinen Vertrag verstoßen. Nimm eine eigene TV-Box.

Claude Code wird unter Termux nicht offiziell unterstützt. Dieser Guide nutzt die API direkt mit einem Python-Skript ohne Abhängigkeiten, damit du davon nicht abhängst.

Der Bot ignoriert alle außer deiner chat_id und öffnet keine Ports. Die Schlüssel liegen nur in einer Datei auf der Box mit Rechten 600. Was du schickst, läuft über Telegram und die Anthropic-API, also gib ihm keine sensiblen Daten.

Vertiefe dasselbe Thema weiter.

Teilen
Newsletter

Erhalte die nächsten Guides per E-Mail

Ideen und Ressourcen zu KI und Marketing, ohne Füllmaterial. Was funktioniert und wie du es anwendest.

Ideen und Ressourcen, kein Spam. Jederzeit abbestellbar.

Hilft dir dieser Guide?

Abonnieren